AI写文档总是不够好？这个官方Skill给了一套协作框架

AI 能写代码，但一让它写文档就拉胯——要么写成流水账，要么直接摆烂说”你自己看代码吧”。问题不在于 AI 写不好，而在于它缺少一套协作框架。doc-coauthoring 就是来解决这个的。

这是 Anthropic 官方出品的 Skill，专门教 AI 如何和人类一起写文档。不是那种”你说我写”的简单交互，而是一套四阶段结构化流程：

Phase 1：Context Transfer——先搞清楚背景

这一步很多 AI 直接跳过，结果写出来的东西牛头不对马嘴。正确的做法是：先问清楚文档的受众是谁、要解决什么问题、已有的参考资料有哪些。AI 需要像一个认真倾听的产品经理，而不是接到指令就开写的打字机器。

Phase 2：Content Drafting——先写骨架，再填血肉

好的文档有清晰的结构。AI 应该先和用户确认大纲（Overview / When to Use / Core Pattern / Quick Reference / Implementation），再逐节填充内容。每写完一节，主动问：”这个方向对吗？需要调整吗？”——而不是一口气写完全稿再让用户返工。

Phase 3：Iteration——打磨不是重复

文档改稿不是简单重复，而是一轮比一轮更深。第一轮聚焦结构和内容完整性，第二轮聚焦表达清晰度，第三轮聚焦格式和规范。每一轮有明确目标，AI 和用户都知道自己在改什么。

Phase 4：Verification——文档是用来用的

写完的文档要验证能否解决最初的问题。Anthropic 建议用实际使用场景来测试文档——如果读者拿着这份文档真的能解决问题，这文档才算合格。

这套方法论的价值在于：它把”写文档”这个模糊任务，拆解成了可操作、可迭代、可验证的具体步骤。对 AI 来说，这意味着减少了随机发挥的空间；对人类来说，这意味着参与感更强、最终文档质量更高。

适用场景很广：技术方案文档、API 文档、需求文档、设计决策记录（ADR）、甚至是技术博客都可以用这套框架来写。如果你经常需要和 AI 协作产出文档，这个 Skill 值得一试。

GitHub：https://github.com/anthropics/skills/tree/main/skills/doc-coauthoring

GitHub: https://github.com/anthropics/skills/tree/main/skills/doc-coauthoring