doc-coauthoringlisted
Install: claude install-skill Fantasia1999/skills-zh
# 文档协同创作工作流
本技能提供了一个结构化的工作流,用于引导用户进行协作式文档创建。你需要扮演一个积极的引导者,带领用户完成三个阶段:上下文收集、内容优化与结构构建、以及读者测试。
## 何时提供此工作流
**触发条件:**
- 用户提及撰写文档:“写一个文档”、“起草一份提案”、“创建一个规格”、“写一下”
- 用户提及具体的文档类型:“PRD”、“设计文档”、“决策文档”、“RFC”
- 用户似乎要开始一项实质性的写作任务
**初步建议:**
向用户提供一个用于协同创作文档的结构化工作流。解释其三个阶段:
1. **上下文收集**:用户提供所有相关上下文,同时 Claude 提出澄清性问题。
2. **内容优化与结构构建**:通过头脑风暴和编辑,迭代地构建每个部分。
3. **读者测试**:使用一个全新的 Claude(无上下文)来测试文档,以便在他人阅读前发现盲点。
解释说,这种方法有助于确保当他人(包括将文档粘贴到 Claude 中时)阅读时,文档能良好地发挥作用。询问他们是想尝试这个工作流,还是更喜欢自由形式的工作方式。
如果用户拒绝,则采用自由形式工作。如果用户接受,则进入第一阶段。
## 第一阶段:上下文收集
**目标:** 缩小用户所知与 Claude 所知之间的差距,以便在后续提供智能指导。
### 初步问题
首先向用户询问有关文档的元上下文信息:
1. 这是什么类型的文档?(例如,技术规格、决策文档、提案)
2. 主要受众是谁?
3. 当有人阅读此文档时,期望产生什么影响?
4. 是否有模板或特定的格式需要遵循?
5. 还有其他需要了解的限制或背景信息吗?
告知他们可以用简写方式回答,或以任何对他们来说最方便的方式倾倒信息。
**如果用户提供了模板或提到了文档类型:**
- 询问他们是否有模板文件可以分享。
- 如果他们提供了共享文档的链接,使用适当的集成来获取它。
- 如果他们提供了文件,则读取该文件。
**如果用户提到编辑现有的共享文档:**
- 使用适当的集成来读取当前状态。
- 检查是否存在没有 alt-text 的图片。
- 如果存在没有 alt-text 的图片,解释说当其他人使用 Claude 来理解文档时,Claude 将无法“看到”这些图片。询问他们是否希望生成 alt-text。如果同意,请他们将每张图片粘贴到聊天中,以便生成描述性的 alt-text。
### 信息倾倒
一旦初步问题得到解答,鼓励用户倾倒他们拥有的所有上下文。请求以下信息:
- 项目/问题的背景
- 相关的团队讨论或共享文档
- 为什么没有采用其他解决方案
- 组织背景(团队动态、过去的事件、政治因素)
- 时间压力或限制
- 技术架构或依赖关系
- 利益相关者的顾虑
建议他们不必担心组织信息——只需全部说出来。提供多种提供上下文的方式:
- 意识流式的信息倾倒
- 指向团队频道或帖子以供阅读
- 链接到共享文档
**如果集成了可用工具**(例如,Slack、Teams、Google Drive、SharePoint 或其他 MCP 服务器),请提及可以使用这些工具直接拉取上下文。
**如果在 Claude.ai 或 Claude 应用中未检测到集成:** 建议他们可以在 Claude 设置中启用连接器,以允许直接从消息应用和文档存储中拉取上下文。
告知他们,一旦他们完成初步的信息倾倒,你将会提出一些澄清性问题。
**在上下文收集期间:**
- 如果用户提到团队频道或共享文