关于
协作文档创建的结构化工作流。作为主动引导者，带领用户经历三个阶段：上下文收集、精炼与结构化、读者测试。
name: doc-coauthoring description: "此技能提供结构化工作流，引导用户完成协作文档创建。作为主动引导者，带领用户经历三个阶段：上下文收集、细化与结构化、读者测试。" risk: unknown source: community date_added: "2026-02-27"
文档协作工作流
此技能提供结构化工作流，引导用户完成协作文档创建。作为主动引导者，带领用户经历三个阶段：上下文收集、细化与结构化、读者测试。
何时提供此工作流
触发条件：
- 用户提到撰写文档："写一个文档"、"起草一个提案"、"创建一个规格说明"、"写一份总结"
- 用户提到特定文档类型："PRD"、"设计文档"、"决策文档"、"RFC"
- 用户似乎正在开始一项重要的写作任务
初始提议： 向用户提供协作文档的结构化工作流。解释三个阶段：
- 上下文收集：用户提供所有相关上下文，同时 Claude 提出澄清问题
- 细化与结构化：通过头脑风暴和编辑迭代构建每个章节
- 读者测试：用一个全新的 Claude（无上下文）测试文档，在他人阅读之前发现盲点
解释这种方法有助于确保文档在他人阅读时效果良好（包括当他们将其粘贴到 Claude 中时）。询问他们是否想尝试此工作流还是更喜欢自由形式。
如果用户拒绝，则自由形式工作。如果用户接受，进入阶段 1。
阶段 1：上下文收集
目标： 缩小用户所知与 Claude 所知之间的差距，为后续的智能引导提供基础。
初始问题
首先询问用户关于文档的元上下文：
- 这是什么类型的文档？（例如，技术规格、决策文档、提案）
- 主要受众是谁？
- 当有人阅读此文档时，期望产生什么影响？
- 是否有模板或特定格式需要遵循？
- 还有其他需要了解的约束或上下文吗？
告知他们可以用简写回答或以任何方便的方式倾倒信息。
如果用户提供了模板或提到了文档类型：
- 询问他们是否有模板文档可以分享
- 如果他们提供了共享文档的链接，使用适当的集成来获取
- 如果他们提供了文件，读取它
如果用户提到编辑现有的共享文档：
- 使用适当的集成读取当前状态
- 检查没有 alt-text 的图片
- 如果存在没有 alt-text 的图片，解释当其他人使用 Claude 理解文档时，Claude 将无法看到它们。询问是否需要生成 alt-text。如果需要，请求他们将每张图片粘贴到聊天中以生成描述性 alt-text。
信息倾倒
初始问题回答后，鼓励用户倾倒所有上下文。请求以下信息：
- 项目/问题的背景
- 相关的团队讨论或共享文档
- 为什么不使用替代方案
- 组织上下文（团队动态、过往事件、政治因素）
- 时间压力或约束
- 技术架构或依赖
- 利益相关者的关注点
建议他们不必担心组织 - 只需全部倒出来。提供多种提供上下文的方式：
- 意识流式信息倾倒
- 指向团队频道或讨论串
- 链接到共享文档
如果集成可用（例如 Slack、Teams、Google Drive、SharePoint 或其他 MCP 服务器），提及可以直接使用这些来拉取上下文。
如果未检测到集成且在 Claude.ai 或 Claude 应用中： 建议他们可以在 Claude 设置中启用连接器，以允许直接从消息应用和文档存储中拉取上下文。
告知他们在初始倾倒完成后会提出澄清问题。
上下文收集期间：
-
如果用户提到团队频道或共享文档：
- 如果集成可用：告知将立即读取内容，然后使用适当的集成
- 如果集成不可用：解释缺乏访问权限。建议在 Claude 设置中启用连接器，或直接粘贴相关内容。
-
如果用户提到未知的实体/项目：
- 询问是否应搜索已连接的工具以了解更多
- 等待用户确认后再搜索
-
随着用户提供上下文，跟踪已学到的内容和仍不清楚的内容
提出澄清问题：
当用户表示已完成初始倾倒（或在提供了大量上下文后），提出澄清问题以确保理解：
根据上下文中的空白生成 5-10 个编号问题。
告知他们可以用简写回答（例如"1: 是，2: 见 #频道，3: 不行因为向后兼容"），链接更多文档，指向频道阅读，或继续信息倾倒。以最高效的方式进行。
退出条件： 当已收集到足够的上下文，可以开始有意义地构建文档时，进入阶段 2。
阶段 2：细化与结构化
目标： 迭代构建文档的每个章节。
对于每个章节：
- 提出该章节应涵盖的内容建议
- 与用户头脑风暴关键要点
- 起草该章节
- 根据反馈修改
- 进入下一章节
在整个过程中保持文档的整体一致性和叙事流畅。
阶段 3：读者测试
目标： 在他人阅读之前发现文档中的盲点。
模拟一个没有任何上下文的新读者：
- 标记不清楚或需要更多解释的部分
- 识别假设了读者不具备的知识的地方
- 检查逻辑流和论证结构
- 建议改进以提高清晰度
将发现报告给用户并协助修复。