doc-coauthoring

Doc Co-Authoring - 协作文档写作工作流

技能概述

一个三阶段结构化文档协作工作流，帮助用户高效收集上下文、迭代优化内容、并通过读者测试验证文档效果。

适用场景

技术文档撰写：撰写技术规范文档、架构设计文档、API文档等技术内容，确保结构清晰、信息完整、读者易懂

决策与提案文档：编写决策文档（Decision Doc）、RFC、提案文档或PRD，通过结构化流程确保逻辑严密、考虑周全

团队协作写作：多人协作文档时，使用统一的工作流减少沟通成本，提升内容质量和一致性

核心功能

上下文收集阶段：通过引导式提问帮助作者系统性收集和整理所有相关背景信息，包括目标受众、项目背景、技术约束、团队动态等，避免遗漏关键上下文

迭代优化阶段：逐节构建文档，每个章节经过提问、头脑风暴、筛选、起草、精修五个步骤，确保内容准确且符合作者期望

读者测试阶段：使用新的AI实例测试文档可读性，预测读者可能提出的问题，发现盲点和模糊表述，在正式发布前优化内容

常见问题

Doc Co-Authoring 工作流适合什么类型的文档？

这个工作流特别适合需要系统性思考和清晰传达的结构化内容，包括技术规范文档、决策文档、设计文档、RFC、PRD、提案文档、项目总结等。对于简单的邮件或快速笔记可能过于繁琐，但任何需要他人认真阅读理解的内容都值得使用。

使用这个工作流写文档需要多长时间？

时间投入取决于文档复杂度和作者准备程度。对于初次使用者，上下文收集阶段可能需要15-30分钟，迭代优化阶段每个章节20-40分钟，读者测试阶段15-30分钟。熟练后可以更快。虽然前期投入更多时间，但能大幅减少后期返工和他人理解沟通的成本。

读者测试阶段具体怎么做？

如果使用支持子Agent的界面（如Claude Code），系统会自动使用新的AI实例测试文档；如果使用网页版，需要打开新对话，只粘贴文档内容而不提供任何背景，然后向AI提问预测的读者问题。如果AI能正确回答且没有误解或指出模糊之处，说明文档通过测试。发现问题则返回迭代阶段修改相关章节。