用途
doc-coauthoring 是一个引导用户协作撰写文档的结构化工作流技能。当用户提出撰写文档、起草提案、编写技术规格、创建决策文档或 RFC 等需求时，该技能会以主动引导者的角色介入，带领用户完成从上下文收集到最终定稿的完整过程。其核心目标是确保文档在他人阅读时（包括被粘贴进 Claude 时）能够被正确理解。
主要能力
该技能提供三阶段工作流：
-
上下文收集（Context Gathering）：先询问文档类型、主要读者、期望影响、是否有模板或格式要求等元信息，再鼓励用户集中倾倒所有相关背景，包括项目背景、团队讨论、替代方案未被采用的原因、组织上下文、时间压力、技术架构、利益相关者关切等。技能会跟踪已知与未知信息，并生成 5-10 个澄清问题。
-
精炼与结构（Refinement & Structure）：按章节逐一构建文档。每节先提出 5-10 个澄清问题，再头脑风暴 5-20 个可能要点，由用户指示保留、删除或合并，随后起草该节并通过逐次编辑迭代完善。技能会优先从未知最多的章节开始（决策文档通常从核心提案开始，规格文档通常从技术方案开始，摘要部分留到最后）。
-
读者测试（Reader Testing）：使用无上下文的全新 Claude 实例模拟读者，预测 5-10 个读者可能提出的问题，测试文档能否被正确理解，并额外检查歧义、错误假设和内部矛盾。发现问题后回到相应章节修正。
使用方式
技能会根据运行环境调整行为，通过 references/RUNTIME-MATRIX.md 判断当前环境是否支持连接器、artifact 或读者测试子代理。若无可用的 artifact 界面，默认在用户指定路径或明确命名的工作文件中创建普通 Markdown 文件。起草完整章节时使用 create_file，所有编辑使用 str_replace，每次修改后提供 artifact 链接。头脑风暴列表不使用 artifact，仅作为对话进行。
适用场景
适用于撰写技术规格、决策文档、提案、RFC、PRD、设计文档等需要多人阅读和理解的文档。特别适合需要确保文档对无背景读者也能清晰传达信息的场景。
限制
该技能依赖运行环境的能力。在 Claude Code 中可直接使用子代理进行读者测试；在 claude.ai 网页界面中则需要用户手动打开新对话进行测试。连接器（如 Slack、Teams、Google Drive、SharePoint 等）的可用性取决于用户设置。若用户拒绝该工作流，技能会转为自由形式协作。技能不编造文档内容，所有信息来自用户提供。