Doc Co-Authoring Workflow 是一个引导用户协作撰写文档的结构化工作流技能，来自 danielsogl/copilot-workflow-demo。它把文档撰写分为三个阶段，由 AI 充当主动引导者。
【用途】 当用户表示要写文档、起草提案、创建规范、撰写说明，或提到 PRD、设计文档、决策文档、RFC 等具体类型时，可提供该工作流。技能会先向用户说明三个阶段，询问用户选择结构化流程还是自由写作；用户拒绝则按自由方式处理。
【主要能力与流程】
- 上下文收集：询问文档类型、主要读者、预期影响、是否有模板或格式要求及其他约束。用户可提供模板链接或文件，技能会读取；若编辑已有共享文档，会检查缺少替代文本的图片。随后鼓励用户集中提供项目背景、相关讨论、未采用其他方案的原因、组织背景、时间压力、技术架构、利益相关者关注点等。技能会提示可借助 Slack、Teams、Google Drive、SharePoint 等集成或 MCP 服务器拉取上下文；没有集成时建议在 Claude 设置中启用连接器，或直接粘贴内容。用户完成初步信息提供后，技能基于缺口生成 5 至 10 个澄清问题，用户可用简写回答。当问题能触及边缘情况和权衡而无需解释基础时，进入下一阶段。
- 细化与结构：按章节构建文档。每节先问 5 至 10 个澄清问题，再头脑风暴 5 至 20 个候选要点，由用户指出保留、删除或合并哪些，然后起草并迭代修改。优先从未知最多的章节开始，如决策文档的核心提案、规范的技术方案，摘要部分留到最后。若结构不明确，技能会建议 3 至 5 个适合该文档类型的章节。创建文档骨架时，若有 Artifact 访问权限则用 create_file 创建，否则在工作目录创建 Markdown 文件，所有章节先放占位文本。起草时用 str_replace 替换占位内容，不重印整篇文档；每次修改后提供 Artifact 链接或确认文件更新。连续三次迭代无实质变化时，询问是否有可删减内容。接近完成时通读全文，检查跨章节流畅性、一致性、冗余、矛盾和空泛填充。
- 读者测试：用无上下文的 Claude 模拟读者，发现作者盲点。若有子代理权限（如 Claude Code），技能会预测 5 至 10 个读者可能提问，逐一用仅含文档内容和问题的子代理测试，并检查歧义、错误假设和矛盾，汇总后回到问题章节修改。若无子代理权限（如 claude.ai 网页版），则指导用户打开新的 Claude 对话，粘贴或分享文档内容，提出生成的问题，并让读者 Claude 回答、指出不清楚之处、说明文档预设的已知知识，以及询问文档可能的歧义、预设知识和内部矛盾，再根据结果迭代。当读者 Claude 能稳定正确回答且不再暴露新缺口时，文档通过测试。
【使用方式】 该技能通过对话引导执行，用户按阶段回答问题、提供上下文、筛选要点并给出修改意见。技能强调用编号方式反馈（如“保留 1、4、7、9”“删除 3，与 1 重复”“合并 11 和 12”），也接受自由反馈并从中提取偏好。
【适用场景】 适合撰写技术规范、决策文档、提案、PRD、RFC 等需要他人阅读理解的文档，尤其适合内容复杂、需要多轮打磨并验证读者可理解性的写作任务。
【限制】 资料未说明安装命令、收费、价格或独立运行平台。技能依赖 Claude 环境，部分能力（Artifact、子代理、Slack、Google Drive 等集成）取决于用户所处平台和权限；无集成或无子代理时需用户手动操作。资料也明确提醒，最终文档的质量和事实核查由用户负责。