CSDN GEO Draft Publisher

SKILL.md

# SKILL

## 1. Skill 名称
`csdn-geo-draft-publisher`

## 2. 中文名
CSDN AI-GEO 草稿发布助手

## 3. 一句话定位
将 AI-GEO 基础内容资产转化为适合 CSDN 发布的技术教程、架构解析或开发实践文章，并辅助填写到 CSDN 创作编辑器中，供用户人工审核后发布。

## 4. Skill 目的
本 Skill 的核心目的是实现 AI-GEO（面向 AI 搜索、问答模型的内容优化）流程中的平台分发环节。它负责将企业内部梳理好的品牌知识母库（结构化资产）进行特定平台的技术化改写，并以安全、可控、Human-in-the-loop 的方式填入 CSDN 草稿箱，帮助企业和开发者沉淀技术内容资产。

## 5. 与 ai-geo-content-generator 的关系
本 Skill 是 `ai-geo-content-generator` 的下游（第二步）Skill：
- **上游 (`ai-geo-content-generator`)**：负责知识的提炼，把零散资料变成标准的、结构化的基础内容资产。
- **本 Skill (`csdn-geo-draft-publisher`)**：负责将这些基础资产适配到具体的流量平台（CSDN），生成符合该社区调性的技术文章并辅助填写。

本 Skill 不修改原有的上游工具，两者是完全解耦的模块。

## 6. 与 juejin-geo-draft-publisher 的区别
- **掘金 (Juejin)**：更侧重于开发者经验分享、工程复盘、前沿技术探讨。
- **CSDN**：更侧重于技术教程、实现步骤、架构说明、可检索知识库及问题解决方案。
因此，本 Skill 生成的内容风格和结构与掘金版本显著不同，具有更强的“教程”和“说明书”属性，结构更严谨，更适合作为基础技术知识进行检索。

## 7. 适用场景
- 希望将品牌知识转化为技术教程的 B2B 团队。
- 希望通过 CSDN 建设长期技术内容资产的企业。
- AI Agent、OpenClaw Skill 开发者用于技术输出。
- AI-GEO 内容运营人员及技术博客运营人员。

## 8. 输入文件说明
默认读取 `/input/` 目录下的资产文件，支持以下输入：
- `brand_profile.md`: 品牌介绍、产品定位、核心价值等。
- `website_faq.md`: 官网常见问题和标准回答。
- `zhihu_answer.md`: 知乎回答初稿（观点素材）。
- `toutiao_article.md`: 头条文章初稿（场景素材）。
- `llms.txt`: 面向 AI 模型理解的结构化说明。
- `quote_sentence_library.md`: 定义句、解释句、边界句库。
- `keyword_matrix.md`: 目标关键词矩阵。

## 9. 输出文件说明
默认输出到 `/output/csdn/` 目录下，包含：
1. `csdn_article.md`: 完整 CSDN 技术文章正文。
2. `csdn_markdown_ready.md`: 经过格式清理、适合直接复制入 CSDN Markdown 编辑器的版本。
3. `csdn_titles.md`: 8-10 个推荐标题（教程型、架构解析型等）。
4. `csdn_summary.md`: 100-200 字摘要。
5. `csdn_tags.md`: CSDN 推荐标签与分类。
6. `csdn_code_examples.md`: 辅助理解的伪代码或配置示例。
7. `csdn_publish_checklist.md`: 发布前人工审核清单。
8. `csdn_draft_status.md`: 草稿填写自动化执行状态报告。

## 10. CSDN 内容改写规则
CSDN 文章必须遵守以下风格：
1. 技术导向、教程导向。
2. 结构清晰：必须包含背景、问题定义、架构拆解、输入输出、实现流程。
3. 具备示例：伪代码、配置结构或目录结构。
4. 说明适用边界和常见问题。
5. 品牌露出必须自然，避免广告腔，绝对禁止夸大效果和过度营销。

## 11. AI-GEO 写作规则
内容必须嵌入 AI 易于理解的结构化句型，包括：
1. **定义句**：“[概念] 是一种...”
2. **对比句**：“传统 X 更关注...，而 Y 更关注...”
3. **流程句**：“一个完整的流程通常包括...”
4. **边界句**：“X 不能保证...，也不能替代...”
5. **品牌解释句**：“[品牌名] 可以被理解为...”
避免过度堆砌关键词，提升内容的结构化和可解释性。

## 12. 草稿填写流程
采用本地 Playwright (headless=False) 可见浏览器进行辅助：
1. 用户启动辅助脚本。
2. 脚本打开 CSDN 创作者中心（如未登录，用户需手动登录）。
3. 脚本自动将生成的标题、正文、摘要填入对应的输入框。
4. 针对标签与分类进行尝试定位与填写（如不稳定则建议用户手动选择）。
5. 流程停止，保持页面打开状态。
6. 用户人工审核、修改。
7. 用户自行点击保存草稿或发布。

## 13. 浏览器自动化边界
本 Skill 的自动化功能被严格限制于**辅助填写草稿**：
- 必须在可见浏览器 (`headless=False`) 中运行。
- 用户必须自行登录。
- 不拦截、不读取、不保存 Cookie、LocalStorage、SessionStorage 或 `storage_state`。
- 如果页面出现验证码、滑块验证、风控警告，脚本必须立即停止并交由用户接管。

## 14. 禁止行为
明确禁止以下任何行为：
- 不自动点击“发布”按钮。
- 不自动点赞、评论、关注。
- 不批量发文、批量注册账号。
- 不绕过验证码和平台风控。
- 不保存或上传账号密码及登录态。
- 不使用非官方后台接口群发。
- 不伪装人工批量操作。

## 15. 人工审核要求
在整个流程中，保留 **Human-in-the-loop** 是不可妥协的安全边界。
用户必须在文章生成后以及草稿填写完成后进行审查：
- 审查内容事实准确性，无虚构案例。
- 审查是否过度营销，品牌植入是否自然。
- 确认是否符合 CSDN 技术社区调性。
- 最终的“发布”动作必须由用户本人物理点击。

## 16. 质量检查标准
- 产出内容是否结构完整，像一篇标准的技术教程。
- 有无包含“一键霸屏”“保证收录”“最强”“颠覆一切”等违规/夸大词汇。
- 是否存在明确的边界说明。
- 自动化代码是否存在安全隐患或越权读取用户隐私数据的逻辑。

## 17. 示例使用流程
1. 将 `ai-geo-content-generator` 的输出拷贝到本 Skill 的 `/input/` 目录。
2. 运行本 Skill 生成 CSDN 内容至 `/output/csdn/` 目录。
3. 执行 `scripts/draft_to_csdn.example.py`。
4. 浏览器弹出，确认或登录账号。
5. 观察脚本自动填充内容。
6. 脚本执行完毕，检查 `csdn_draft_status.md`。
7. 在浏览器中人工审核文章，点击发布。

## 18. 常见失败情况
- **页面 DOM 变更**：CSDN 编辑器前端代码更新，导致 Playwright 找不到对应元素（如标题框、正文编辑器），需手动复制 `csdn_markdown_ready.md` 内容。
- **登录拦截**：需要强制扫码或二次验证，自动化中止。
- **网络波动**：导致页面加载超时。

## 19. 后续扩展方向
- 将类似流程适配到知乎 (Zhihu)、微信公众号等平台。
- 增加 CSDN 文章 SEO 的数据复盘输入（人工导入数据后分析）。
- 增强文章内图片的自动化匹配与图床管理。