
关于
协作文档创建的结构化工作流。作为主动引导者,带领用户经历三个阶段:上下文收集、精炼与结构化、读者测试。
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:读者测试
目标: 在他人阅读之前发现文档中的盲点。
模拟一个没有任何上下文的新读者:
- 标记不清楚或需要更多解释的部分
- 识别假设了读者不具备的知识的地方
- 检查逻辑流和论证结构
- 建议改进以提高清晰度
将发现报告给用户并协助修复。