doc-coauthoring 是一个指导用户协作撰写文档的结构化工作流技能,分三个阶段。触发场景包括用户提到撰写文档、起草提案、创建规格、PRD、设计文档、决策文档或 RFC,或正要开始一项较长的写作任务。使用时先向用户说明三个阶段并询问是否采用该流程,若拒绝则自由撰写。\n\n阶段一:上下文收集。先询问文档类型、主要读者、期望影响、是否有模板及约束;若用户提供模板或链接,则借集成读取,并检查图片是否缺少 alt 文本。随后鼓励用户倾倒全部背景信息,如项目背景、团队讨论、备选方案为何未采用、组织情况、时间压力、技术架构、利益相关者关切等。若检测到 Slack、Teams、Google Drive、SharePoint 等集成或 MCP 服务器,可直接拉取上下文;没有集成时建议在 Claude 设置中启用连接器或手动粘贴。之后基于缺口提出 5-10 个澄清问题,可速记作答。当问题可触及边界情况与权衡时进入下一阶段。\n\n阶段二:精炼与结构。逐节构建文档:提出澄清问题、头脑风暴 5-20 个要点、由用户保留/删除/合并、起草该节、再逐步修改。先从未知最多的部分开始,摘要部分最后写。结构清晰时由用户选起始节;不清晰时按文档类型建议 3-5 个章节。可用时用 create_file 建立含占位文本的 artifact,否则在工作目录创建 markdown 文件。每节用 str_replace 替换占位内容,鼓励用户指出修改而非直接编辑。连续三轮回无实质改动时询问是否可删减。接近完成时通读全文检查连贯性、冗余、矛盾与模板化填充内容。\n\n阶段三:读者测试。用无上下文的 Claude 验证文档是否对读者有效。可用子代理时,预测 5-10 个读者问题,逐一在子代理中测试并汇总对错,再检查歧义、错误假设与矛盾,报告问题并回到精炼阶段修复。无子代理时由用户手动在新的 Claude 对话中测试,粘贴文档并提问,同时要求读者 Claude 指出歧义、预设知识与内部矛盾。当读者 Claude 持续答对且不再浮现新缺口时,文档即就绪。\n\n最后建议用户亲自通读、核对事实与链接、确认达成预期影响,并提示可附录对话链接、用附录提供深度、根据真实读者反馈更新。执行时应保持直接、程序化,不推销方法;用户想跳过阶段时询问是否改为自由撰写,并始终保留用户调整流程的自主权。所有编辑使用 str_replace,每次改动后提供 artifact 链接;头脑风暴列表不使用 artifact。
doc-coauthoring
通用与其它
更新于 10-16 05:45