[ PROMPT_NODE_25982 ]
doc-coauthoring
[ SKILL_DOCUMENTATION ]
# 文档协作编写工作流
此技能提供了一个结构化的工作流,用于引导用户进行协作文档创建。作为积极的向导,引导用户经历三个阶段:背景收集、细化与结构化、以及读者测试。
## 何时提供此工作流
**触发条件:**
- 用户提到编写文档:“写文档”、“起草提案”、“创建规范”、“撰写”
- 用户提到特定文档类型:“PRD”、“设计文档”、“决策文档”、“RFC”
- 用户似乎要开始一项重要的写作任务
**初步建议:**
向用户提供一个结构化的文档协作编写工作流。解释这三个阶段:
1. **背景收集**:用户提供所有相关背景,同时 Claude 提出澄清问题
2. **细化与结构化**:通过头脑风暴和编辑迭代构建每个部分
3. **读者测试**:使用全新的 Claude(无上下文)测试文档,在他人阅读前发现盲点
解释这种方法有助于确保文档在他人阅读时效果良好(包括他们将其粘贴到 Claude 中时)。询问他们是否想尝试此工作流,还是更喜欢自由发挥。
如果用户拒绝,则自由发挥。如果用户接受,则进入第 1 阶段。
## 第 1 阶段:背景收集
**目标:** 缩小用户已知信息与 Claude 已知信息之间的差距,为后续的智能指导提供支持。
### 初始问题
首先询问用户关于文档的元背景信息:
1. 这是什么类型的文档?(例如:技术规范、决策文档、提案)
2. 主要受众是谁?
3. 阅读此文档时希望达到什么效果?
4. 是否有模板或特定格式需要遵循?
5. 还有其他需要了解的约束或背景吗?
告知他们可以用简写回答,或以任何最适合他们的方式提供信息。
**如果用户提供了模板或提到了文档类型:**
- 询问他们是否有模板文档可以分享
- 如果他们提供了共享文档的链接,使用适当的集成来获取它
- 如果他们提供了文件,则读取它
**如果用户提到编辑现有的共享文档:**
- 使用适当的集成来读取当前状态
- 检查是否有缺少替代文本(alt-text)的图像
- 如果存在缺少替代文本的图像,解释当其他人使用 Claude 理解文档时,Claude 将无法看到它们。询问他们是否需要生成替代文本。如果需要,请求他们将每张图像粘贴到聊天中以生成描述性替代文本。
### 信息转储
一旦回答了初始问题,