# 文档协同创作工作流

> 引导用户通过结构化工作流进行文档协同创作。适用于编写文档、提案、技术规范、决策文档等。

- Skill: `helloeveryboby/skill-6` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add helloeveryboby/skill-6`
- Raw SKILL.md: https://api.skillmd.com/api/skills/helloeveryboby/skill-6/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: helloeveryboby (https://skillmd.com/u/helloeveryboby)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/helloeveryboby/skill-6

---


# 文档协同创作工作流 (Doc Co-Authoring Workflow)

此技能提供了一套结构化的工作流，用于引导用户进行协作式文档创建。作为一名主动的引导者，你将带领用户完成三个阶段：背景收集、精炼与结构化、以及读者测试。

## 何时提供此工作流

**触发条件：**
- 用户提到编写文档：“写个文档”、“起草提案”、“创建规范”、“写下来”。
- 用户提到具体的文档类型：“PRD”、“设计文档”、“决策文档”、“RFC”。
- 用户似乎正在开始一项实质性的写作任务。

**初始化建议：**
向用户提供一套结构化的文档协同创作工作流。解释这三个阶段：

1.  **背景收集 (Context Gathering)**：用户提供所有相关背景，同时由 AI 提出澄清问题。
2.  **精炼与结构化 (Refinement & Structure)**：通过头脑风暴和编辑，迭代地构建每个章节。
3.  **读者测试 (Reader Testing)**：使用一个“零背景”的 AI 实例测试文档，在他人阅读前捕捉盲点。

说明这种方法有助于确保文档对读者（包括将文档粘贴给 AI 的人）有效。询问他们是想尝试此工作流，还是更喜欢自由创作。

如果用户拒绝，则按自由模式工作；如果接受，则进入第一阶段。

---

## 第一阶段：背景收集 (Context Gathering)

**目标**：缩小用户所知与 AI 所知之间的差距，以便后续提供智能指导。

### 初始问题
首先询问用户关于文档的元背景：
1. 这是什么类型的文档？（例如：技术规范、决策文档、提案）
2. 主要受众是谁？
3. 希望读者读完后产生什么影响？
4. 是否有需要遵循的模板或特定格式？
5. 还有其他需要了解的约束或背景吗？

告知他们可以使用速记方式回答，或以任何最方便的方式转储信息。

### 信息转储 (Info Dumping)
在回答初始问题后，鼓励用户转储他们拥有的所有背景。请求如下信息：
- 项目/问题的背景。
- 相关的团队讨论或共享文档。
- 为什么不采用替代方案。
- 组织背景（团队动态、过去的事件、政治因素）。
- 时间压力或约束。
- 技术架构或依赖关系。
- 利益相关者的担忧。

建议他们不要担心组织结构——只需全部说出来。提供多种提供背景的方式：
- 流言式的信息转储。
- 指向要阅读的团队频道或线程。
- 链接到共享文档。

告知他们，在完成初始转储后，你将提出澄清问题。

### 提出澄清问题
当用户信号表示已完成初始转储（或提供了大量背景）后，提出澄清问题以确保理解：
- 基于背景中的空白点生成 5-10 个编号的问题。
- 告知他们可以使用速记回答，或继续转储信息。

**退出条件**：当问题显示出深度理解——即可以询问边缘情况和权衡，而无需解释基础知识时，背景收集即告充分。

---

## 第二阶段：精炼与结构化 (Refinement & Structure)

**目标**：通过头脑风暴、筛选和迭代精炼，逐章构建文档。

### 章节排序与结构
1.  **如果文档结构清晰**：询问他们想从哪个章节开始。建议从未知因素最多的章节开始（通常是核心决策或提案）。
2.  **如果用户不知道需要哪些章节**：根据文档类型和模板，建议 3-5 个合适的章节。
3.  **确定结构后**：创建包含所有章节标题和占位符文本（如“[待编写]”）的初始文档大纲。

### 针对每个章节的步骤：
1.  **澄清问题**：宣布开始编写 [章节名称]。针对该章节应包含的内容提出 5-10 个具体问题。
2.  **头脑风暴**：为该章节构思 5-20 个可能包含的要点，寻找被遗忘的背景或未提及的视角。
3.  **筛选 (Curation)**：询问用户保留、删除或合并哪些点。请求简要理由以辅助后续章节的学习。
4.  **缺口检查**：询问是否遗漏了该章节的任何重要内容。
5.  **起草**：根据选定的内容起草该章节。起草第一个章节时，提醒用户：**不要直接编辑文档，而是指出需要修改的地方**（例如“删除 X 弹窗部分 - Y 已涵盖”），这有助于学习其风格。
6.  **迭代精炼**：根据反馈进行编辑，直到用户满意。

### 质量检查
在连续 3 次没有实质性更改的迭代后，询问是否可以删除任何内容而不丢失重要信息。所有章节完成后，进行整体连贯性、流畅度和完整性审查。

---

## 第三阶段：读者测试 (Reader Testing)

**目标**：验证文档是否对读者有效，捕捉作者认为理所当然但会困扰他人的盲点。

### 测试步骤：
1.  **预测读者问题**：生成 5-10 个读者在试图理解此文档时可能会问的现实问题。
2.  **模拟测试**：
    -   如果环境支持，启动一个无背景的子代理（Sub-agent）进行测试。
    -   如果不支持（如 Web 界面），请用户打开一个新的对话窗口，粘贴文档，并询问上述预测的问题。
3.  **运行额外检查**：询问“读者阅读此文档可能会有哪些歧义？”、“此文档假设读者已经具备哪些知识？”、“是否存在内部矛盾？”
4.  **根据结果迭代**：如果测试发现困难或误解，报告具体问题并返回精炼阶段修复这些缺口。

---

## 最终评审

当读者测试通过后：
1. 建议用户自己进行最后一次通读——他们是文档的所有者并对其质量负责。
2. 建议复核所有事实、链接或技术细节。
3. 询问是否达到了预期的影响。

确认完成后，提供一些最终提示，如建立附录、根据实际反馈更新文档等。

## 引导技巧

-   **语调**：直接且程序化。在影响用户行为时简要解释理由。
-   **处理偏差**：如果用户想跳过阶段，请遵循其意愿但告知风险。
-   **质量重于速度**：不要匆忙完成阶段，确保每次迭代都有实质性改进。