用途
该技能提供一套结构化工作流，引导用户协作完成文档创作。代理充当主动引导者，带用户走过三个阶段：上下文收集、精炼与结构、读者测试。
核心原则：用户掌握上下文，代理掌握结构。工作流的目标是高效地把用户的上下文转移给代理，然后逐节构建文档，使用户不必审阅一整面自己未曾参与塑造的文字。
三个阶段各自解决的问题：
- 阶段一（上下文收集）：避免代理因缺乏组织上下文而写出看似合理却错误的内容。
- 阶段二（精炼与结构）：避免用户拿到一份成品草稿后还要反向推断该改什么。
- 阶段三（读者测试）：避免文档只有作者看得懂、其他人一头雾水。阶段三最常被跳过，也最能发现问题。
主要能力
- 提供待办清单，逐项推进；阶段顺序执行，阶段二内部各节循环。
- 阶段一：提出元问题（文档类型、受众、期望影响、模板、约束），让用户倾倒信息，再提出 5-10 个澄清问题。
- 阶段二：先商定结构，创建带占位符的文件；每节按“提问 → 头脑风暴 5-20 项 → 用户筛选 → 缺口检查 → 起草 → 精炼”推进；最后通读全文检查流畅度、冗余、矛盾与填充内容。
- 阶段三：用无上下文的全新代理回答预测的读者问题，并检查歧义、错误假设与矛盾。
使用方式
当用户提到撰写文档（如“写个文档”“起草提案”“创建规格”“写出来”）或具体文档类型（PRD、设计文档、决策文档、RFC），或似乎要开始一项较大的写作任务时，可提供此工作流。
初始提议：向用户说明三个阶段，询问是否采用该工作流，还是自由发挥。用户拒绝则自由发挥；接受则进入阶段一。
阶段一：先问元上下文问题，告知可用简写回答。若用户提供模板或文档类型，询问是否有模板文档可分享；若提供共享文档链接，用相应集成获取；若提供文件则读取。若涉及编辑已有共享文档，读取当前状态并检查无替代文本的图片，说明他人用代理理解文档时看不到这些图片，询问是否生成替代文本。随后鼓励用户倾倒全部上下文，并说明之后会提澄清问题。若检测到集成（如 Slack、Teams、Google Drive、SharePoint 或其他 MCP 服务器），可说明能直接拉取上下文；若无集成且在托管代理界面，可建议在代理设置中启用连接器。当用户表示倾倒完毕，生成 5-10 个编号澄清问题。退出条件：能就边缘情况和权衡提问而无需解释基础概念。
阶段二：向用户说明将逐节构建。若结构清晰，询问从哪节开始，建议从未知最多的节开始（决策文档通常是核心提案，规格通常是技术方案，摘要留到最后）。若用户不知需要哪些节，根据文档类型和模板建议 3-5 个节并确认。结构商定后，创建带所有节标题和占位文本（如“[待撰写]”）的初始文档：若有工件渲染，用 write 工具创建工件并提供文件路径；若无，在工作目录创建 markdown 文件（如 decision-doc.md、technical-spec.md）。每节流程：步骤1 提出 5-10 个澄清问题；步骤2 头脑风暴 5-20 个可能包含的点，并提示可要求更多；步骤3 请用户指出保留、删除或合并哪些，并给出简要理由；步骤4 缺口检查；步骤5 用 edit 工具替换占位文本起草，请用户阅读并指出要改之处（建议不要直接编辑文档，而是说明要改什么，以便学习其风格）；步骤6 迭代精炼，用 edit 工具修改而非重印全文。质量检查：连续 3 次迭代无实质变化后，询问是否有可删除而不丢失重要信息的内容。接近完成（80% 以上节完成）时，通读全文检查流畅度、一致性、冗余、矛盾、填充内容及每句是否都有分量。
阶段三：用无上下文的全新代理测试文档。若有子代理（如 opencode 的 task 工具），直接测试：预测 5-10 个读者会问的问题，用仅含文档内容和问题的子代理逐一测试，汇总对错；再运行额外检查（歧义、错误假设、矛盾）；报告并修复问题，回到问题节精炼。若无子代理，用户需手动测试：预测读者问题，开启无上下文的全新代理会话，粘贴或分享文档内容，提问并让读者代理给出答案、指出歧义、说明文档假设的已知知识，再问“文档中哪些可能含糊”“假设读者已知什么”“有无内部矛盾”，根据结果迭代。退出条件：读者代理持续正确回答且不暴露新缺口或歧义。
最终审查：宣布通过读者代理测试后，建议用户自己最后通读一遍（文档归其所有，质量由其负责），复核事实、链接、技术细节，确认达到期望影响，询问是否还需一次审查。完成后可提供提示：考虑在附录中链接本次对话；用附录提供深度而不臃肿正文；根据真实读者反馈更新文档。
适用场景
- 撰写技术规格、提案、决策文档、PRD、RFC 等。
- 用户开始一项较大的写作任务。
- 需要确保文档对作者之外的读者也清晰有效。
限制
- 阶段三依赖子代理或用户手动测试；无子代理时需用户自行操作。
- 集成（Slack、Teams、Google Drive、SharePoint、MCP 等）是否可用取决于环境；无集成时需用户粘贴内容或启用连接器。
- 工件渲染是否可用取决于环境；不可用时改用工作目录中的 markdown 文件。
- 具体收费、价格、平台支持等信息暂未提供。