Doc Co-Authoring Skill

Doc Co-Authoring Skill 是什么？

Doc Co-Authoring Skill 是一套协作文档工作流，适合技术方案、提案、PRD、RFC、决策记录和其他结构化文档。它把写作分为背景收集、结构与内容迭代、读者测试三个阶段，重点解决作者知道很多但文档没有写清楚的问题。

第一阶段：收集背景

Skill 会先确认文档类型、目标读者、希望产生的影响、模板和限制，然后让用户以方便的方式提供项目背景、替代方案、时间压力、依赖和利益相关者关注点。收集到足够信息后，再针对缺口提出问题。

第二阶段：共同写作

文档按章节推进。每一节先澄清目标，再列出可选内容，由用户决定保留、删除或合并哪些观点，随后起草并做局部修改。通常先写最不确定的核心部分，摘要留到最后。

第三阶段：读者测试

接近完成时，Skill 会预测读者可能提出的问题，并尽量用没有前文背景的新上下文测试文档，找出术语未解释、假设缺失和逻辑跳跃。根据结果修订，直到目标读者能够独立理解。

适用边界

短消息或只需润色几句话的任务不一定需要完整流程。协作效率取决于用户是否能提供关键背景。接入共享文档或团队沟通工具时，应确认权限并避免读取无关敏感信息。

许可证

该 Skill 目录当前未附独立许可证文件，且仓库根目录未声明统一许可证。公开可读不等于允许任意再分发，使用前应核对上游授权。

常见问题 FAQ

1. 适合写哪些文档？

适合提案、技术规格、设计文档、PRD、RFC 和决策记录等。

2. 必须按完整流程执行吗？

不是。用户可以选择结构化流程，也可以继续自由协作。

3. 为什么要先大量提供背景？

这样可以缩小作者认知与 AI 上下文之间的差距，减少空泛内容。

4. 文档应该从摘要开始写吗？

通常不建议，先解决最不确定的核心章节，摘要在内容稳定后更容易写准。

5. 什么是读者测试？

让缺少前文背景的读者或新上下文阅读，检查文档能否独立成立。

6. 能读取共享文档吗？

在具备相应连接器和授权时可以，否则需要用户上传或粘贴内容。

7. 图片没有替代文字怎么办？

工作流会提醒补充替代文字，方便读者和 AI 理解图中信息。

8. 一句话修改也适合吗？

通常没必要，简单编辑直接处理更高效。

来源与核验说明

本条目根据 Anthropic 官方 Skills 仓库中的 doc-coauthoring 工作流整理。