| 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