doc-coauthoring
引导用户通过结构化的流程共同编写文档。当用户想要编写文档、提案、技术规范、决策文档或类似的结构化内容时使用。此工作流帮助用户高效地传递上下文、通过迭代优化内容,并验证文档对读者是否有效。当用户提到编写文档、创建提案、起草规范或类似的文档任务
技能说明anthropics/skills
引导用户通过结构化的流程共同编写文档。当用户想要编写文档、提案、技术规范、决策文档或类似的结构化内容时使用。此工作流帮助用户高效地传递上下文、通过迭代优化内容,并验证文档对读者是否有效。当用户提到编写文档、创建提案、起草规范或类似的文档任务时触发。
技能简介
doc-coauthoring 是一个文档共同创作工作流技能。它通过结构化的三阶段流程——Context Gathering(上下文收集)、Refinement & Structure(优化与结构)、Reader Testing(读者测试)——引导用户高效编写文档,帮助传递上下文、迭代优化内容,并在文档对外发布前验证其是否对读者真正有效。
使用场景
- 编写 PRD、设计文档、决策文档、RFC 等技术文档
- 起草提案、技术规范或类似的结构化内容
- 需要将团队讨论、共享文档等零散上下文整理成正式文档
- 希望文档在张贴到 Claude 或其他 AI 工具时能被准确理解
使用方法
该技能作为 Claude Skill 使用,无需额外安装。当用户提到"写文档""起草提案""创建规范"等任务时自动触发。
启用流程:
-
触发与确认:Agent 检测到写作任务后,会主动提出使用该结构化工作流,并向用户说明三阶段流程。用户可选择接受,或选择自由写作模式。
-
阶段一:上下文收集(Context Gathering)
Agent 会先询问文档类型、目标读者、期望影响、模板/格式要求等元信息。随后鼓励用户进行信息倾倒(Info Dump),并针对上下文中的空白提出 5-10 个澄清问题。如果检测到已集成的工具(如 Slack、Google Drive、SharePoint 等 MCP 服务),可直接拉取相关文档和对话记录。 -
阶段二:优化与结构(Refinement & Structure)
逐节构建文档。对每一节,Agent 会提出澄清问题、头脑风暴 5-20 个可选方案、由用户决定保留/删除/合并内容,然后完成初稿并通过精准修改逐步优化。 -
阶段三:读者测试(Reader Testing)
用一个没有上下文的"全新 Claude"来测试文档,验证其他读者(或 AI)在没有任何背景信息的情况下能否理解内容,以发现盲点并进行最终修订。
注意事项
- 用户随时可以拒绝结构化工作流,选择自由写作方式,Agent 会尊重这一选择。
- 如果用户提供的共享文档中包含没有 alt-text 的图片,Claude 将无法理解这些图片内容,需要用户将图片粘贴到对话中以便生成描述文字。
- 在无集成工具可用的环境中,用户可在 Claude 设置中启用 Connectors,或直接将相关内容粘贴到对话中。