Skill: ljseeking/csdn-geo-draft-publisher (version 1.0.0)

# 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 的数据复盘输入（人工导入数据后分析）。 - 增强文章内图片的自动化匹配与图床管理。


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)