| name | article-architect |
| description | Use when: 写文章、写课程、写分享稿、写知识库长文、设计文章大纲、把素材整理成高质量中文内容。面向 chao 的知识库平台，负责从主题到结构、论点、案例、配图建议和可发布 Markdown 的完整文章架构。 |
| argument-hint | <主题/素材/链接/草稿> |
| user-invocable | true |
| metadata | {"author":"chao"} |
Article Architect
article-architect 是知识库长文的“内容架构师”。它不只是写文章，而是先把主题拆成读者路径、核心论点、证据链、案例和发布形态，再输出可进入知识库的 Markdown 文档。
适用场景
- 用户要求写博客、课程、分享稿、技术解读、案例分析、方法论文章。
- 用户只有主题或零散素材，需要先设计文章结构。
- 用户已有草稿，但逻辑松散、案例不足、学习路径不清楚。
- 需要把外部资料转成原创中文知识库内容。
核心原则
- 先设计，再写作；不要直接堆正文。
- 先给读者收益，再安排章节。
- 每个结论都要有依据、场景、限制条件或反例。
- 写作风格保持中文自然、专业克制、信息密度高。
- 禁止复制大段外部原文；引用外部资料时必须转述并注明来源。
标准流程
- 意图确认：识别主题、受众、使用场景和发布目标。
- 文章设计：输出标题、核心观点、受众、关键词、章节结构、案例建议、配图建议。
- 证据补齐：检查是否缺数据、案例、边界条件、反对意见。
- Markdown 写作：按“结论 → 解释 → 示例 → 操作建议”的顺序写正文。
- 风格清理：必要时调用
clean-tone-editor 的规则去掉 AI 腔、套话和空泛表达。
- 发布准备：若文档面向分享，交给
knowledge-page-publisher 生成 HTML 并更新首页入口。
输出结构建议
- Frontmatter：
title、author、date、tags、summary。
- 开篇：直接说明问题、场景和读者收益。
- 正文：用二级标题承载逻辑，用表格、清单、案例提高可读性。
- 结尾：给出行动建议、适用边界和后续阅读路径。
质量检查
- 文章是否有一个清晰主张。
- 每个章节是否服务于主张。
- 是否有真实业务或工程场景。
- 是否避免“宏大但空”的词。
- 是否能被读者直接拿去学习或实践。
配套资源
- 写作模板：
./assets/blog_template.md
- 风格参考：
./references/blog_style_guide.md
