helloeveryboby 文档协同创作工作流 (Doc Co-Authoring Workflow)
此技能提供了一套结构化的工作流，用于引导用户进行协作式文档创建。作为一名主动的引导者，你将带领用户完成三个阶段：背景收集、精炼与结构化、以及读者测试。
何时提供此工作流
触发条件：
- 用户提到编写文档：“写个文档”、“起草提案”、“创建规范”、“写下来”。
- 用户提到具体的文档类型：“PRD”、“设计文档”、“决策文档”、“RFC”。
- 用户似乎正在开始一项实质性的写作任务。
初始化建议： 向用户提供一套结构化的文档协同创作工作流。解释这三个阶段：
- 背景收集 (Context Gathering)：用户提供所有相关背景，同时由 AI 提出澄清问题。
- 精炼与结构化 (Refinement & Structure)：通过头脑风暴和编辑，迭代地构建每个章节。
- 读者测试 (Reader Testing)：使用一个“零背景”的 AI 实例测试文档，在他人阅读前捕捉盲点。
说明这种方法有助于确保文档对读者（包括将文档粘贴给 AI 的人）有效。询问他们是想尝试此工作流，还是更喜欢自由创作。
如果用户拒绝，则按自由模式工作；如果接受，则进入第一阶段。
第一阶段：背景收集 (Context Gathering)
目标：缩小用户所知与 AI 所知之间的差距，以便后续提供智能指导。
初始问题
首先询问用户关于文档的元背景：
- 这是什么类型的文档？（例如：技术规范、决策文档、提案）
- 主要受众是谁？
- 希望读者读完后产生什么影响？
- 是否有需要遵循的模板或特定格式？
- 还有其他需要了解的约束或背景吗？
告知他们可以使用速记方式回答，或以任何最方便的方式转储信息。
信息转储 (Info Dumping)
在回答初始问题后，鼓励用户转储他们拥有的所有背景。请求如下信息：
- 项目/问题的背景。
- 相关的团队讨论或共享文档。
- 为什么不采用替代方案。
- 组织背景（团队动态、过去的事件、政治因素）。
- 时间压力或约束。
- 技术架构或依赖关系。
- 利益相关者的担忧。
建议他们不要担心组织结构——只需全部说出来。提供多种提供背景的方式：
- 流言式的信息转储。
- 指向要阅读的团队频道或线程。
- 链接到共享文档。
告知他们，在完成初始转储后，你将提出澄清问题。
提出澄清问题
当用户信号表示已完成初始转储（或提供了大量背景）后，提出澄清问题以确保理解：
- 基于背景中的空白点生成 5-10 个编号的问题。
- 告知他们可以使用速记回答，或继续转储信息。
退出条件：当问题显示出深度理解——即可以询问边缘情况和权衡，而无需解释基础知识时，背景收集即告充分。
第二阶段：精炼与结构化 (Refinement & Structure)
目标：通过头脑风暴、筛选和迭代精炼，逐章构建文档。
章节排序与结构
- 如果文档结构清晰：询问他们想从哪个章节开始。建议从未知因素最多的章节开始（通常是核心决策或提案）。
- 如果用户不知道需要哪些章节：根据文档类型和模板，建议 3-5 个合适的章节。
- 确定结构后：创建包含所有章节标题和占位符文本（如“[待编写]”）的初始文档大纲。
针对每个章节的步骤：
- 澄清问题：宣布开始编写 [章节名称]。针对该章节应包含的内容提出 5-10 个具体问题。
- 头脑风暴：为该章节构思 5-20 个可能包含的要点，寻找被遗忘的背景或未提及的视角。
- 筛选 (Curation)：询问用户保留、删除或合并哪些点。请求简要理由以辅助后续章节的学习。
- 缺口检查：询问是否遗漏了该章节的任何重要内容。
- 起草：根据选定的内容起草该章节。起草第一个章节时，提醒用户：不要直接编辑文档，而是指出需要修改的地方（例如“删除 X 弹窗部分 - Y 已涵盖”），这有助于学习其风格。
- 迭代精炼：根据反馈进行编辑，直到用户满意。
质量检查
在连续 3 次没有实质性更改的迭代后，询问是否可以删除任何内容而不丢失重要信息。所有章节完成后，进行整体连贯性、流畅度和完整性审查。
第三阶段：读者测试 (Reader Testing)
目标：验证文档是否对读者有效，捕捉作者认为理所当然但会困扰他人的盲点。
测试步骤：
- 预测读者问题：生成 5-10 个读者在试图理解此文档时可能会问的现实问题。
- 模拟测试：
- 如果环境支持，启动一个无背景的子代理（Sub-agent）进行测试。
- 如果不支持（如 Web 界面），请用户打开一个新的对话窗口，粘贴文档，并询问上述预测的问题。
- 运行额外检查：询问“读者阅读此文档可能会有哪些歧义？”、“此文档假设读者已经具备哪些知识？”、“是否存在内部矛盾？”
- 根据结果迭代：如果测试发现困难或误解，报告具体问题并返回精炼阶段修复这些缺口。
最终评审
当读者测试通过后：
- 建议用户自己进行最后一次通读——他们是文档的所有者并对其质量负责。
- 建议复核所有事实、链接或技术细节。
- 询问是否达到了预期的影响。
确认完成后，提供一些最终提示，如建立附录、根据实际反馈更新文档等。
引导技巧
- 语调：直接且程序化。在影响用户行为时简要解释理由。
- 处理偏差：如果用户想跳过阶段，请遵循其意愿但告知风险。
- 质量重于速度：不要匆忙完成阶段，确保每次迭代都有实质性改进。