Claude写文档老跑偏？用这个官方工作流让它真正听懂你的需求

Claude 一本正经地帮你写文档，结果全是车轱辘话？

问题不在它”不够聪明”——而是你没给它一套真正管用的写作流程。

今天推荐一个我见过最系统的 Claude 文档协作 Skill：doc-coauthoring，来自 Anthropic 官方，107k Stars，写文档前先把它装上。

三个阶段，把 Claude 变成”文档副驾”

这个 Skill 的核心是一套三阶段迭代工作流：

第一阶段：Context Gathering（信息收集）

不是让 Claude 直接开写，而是先让它向你提问——背景是什么、目标读者是谁、想要达成什么影响、有没有现成模板。

它会一口气问 5~10 个澄清性问题，把”你脑子里的东西”倒出来，然后才进入下一步。这直接解决了 Claude 写文档时最常见的 bug：瞎编不存在的背景信息。

第二阶段：Refinement & Structure（迭代打磨）

每个章节单独处理：
– 头脑风暴：一次生成 5~20 个内容选项供你挑选
– 用户筛选：你说”保留 1、4、7″，它照做
– 精准改写：用 str_replace 只改那一段，不全文重排
– 循环迭代：直到你觉得这个章节 OK 了，再进入下一个

第三阶段：Reader Testing（读者测试）

最后一步最关键——找另一个”空白 Claude”来读这份文档，看它能不能正确回答关于这份文档的问题。

如果 Reader Claude 答不上来，说明文档里有些”你默认它知道、但读者其实不知道”的东西。这个阶段直接把这个盲区抓出来，而不是文档发出去了才被同事吐槽”看不懂”。

为什么强烈推荐这个 Skill？

1. 防幻觉一把好手

Claude 写文档最怕的就是”你不说它就编”——有了这个 Skill，它必须等你喂信息，信息不全它就停下来问你，不会在空白基础上自由发挥。

2. 结构化输出，质量稳定

不是每次都靠”这次 prompt 写得好不好”来决定输出质量，而是靠一套无论谁用、结果都在线的工作流程。

3. 适用场景极广

PRD、RFC、技术方案、决策文档、提案、标准操作流程……只要是需要”认真写”的文档类型，都可以套用这个 workflow。

4. 多 Agent 支持

不只是 Claude Code，还支持 Codex CLI、Gemini CLI、OpenCode、OpenClaw，以及 Cursor、Windsurf、Cline 等主流 AI 编程工具。

安装方式

直接进入 Claude Code，运行：

/plugin install doc-coauthoring@claude-plugins-official

或者手动把 SKILL.md 复制到 ~/.claude/skills/ 目录。

总结一下：doc-coauthoring 不是一个”帮你写文档的 Skill”，而是一个教你和 AI 协作写出好文档的流程 Skill。它把 AI 辅助写作从随机的”灵光一现”变成可复制的系统方法论。

建议每个经常需要写技术文档的朋友都装上，用几次之后你就不想删了。

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

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