SuperAPI AI 工具集

doc-coauthoring

写作与研究

查看项目

更新于 10-16 10:12

技能介绍

用途

Doc Co-Authoring Workflow 是一个用于指导用户协作创建文档的结构化工作流技能。当用户提到“写文档”“起草提案”“创建规格”“写出来”,或提到特定文档类型如“PRD”“设计文档”“决策文档”“RFC”,或用户似乎要开始一项实质性写作任务时,可提供此工作流。

主要能力

技能提供三个阶段的协作流程:

  1. 上下文收集(Context Gathering):用户在 Claude 提出澄清问题的同时提供所有相关上下文。开始时会询问文档元上下文,包括文档类型、主要受众、读者阅读后期望产生的影响、是否有模板或特定格式、其他约束或背景。随后鼓励用户倾倒所有上下文,包括项目/问题背景、相关团队讨论或共享文档、为何不使用替代方案、组织背景、时间线压力或约束、技术架构或依赖、利益相关者关注点。用户可以以意识流方式倾倒信息、指向团队频道或线程、链接共享文档。如果可用集成(如 Slack、Teams、Google Drive、SharePoint 或其他 MCP 服务器),可直接拉取上下文。若未检测到集成且在 Claude.ai 或 Claude 应用中,会建议用户在 Claude 设置中启用连接器。用户表示完成初步倾倒后,技能会基于上下文缺口生成 5-10 个编号澄清问题,用户可用简写回答。退出条件:当问题显示出理解——即无需解释基础内容即可询问边缘情况和权衡时,表示已收集足够上下文。

  2. 细化与结构(Refinement & Structure):通过头脑风暴、筛选和迭代细化逐节构建文档。每个部分依次进行:澄清问题(5-10 个)、头脑风暴(根据复杂度 5-20 个选项)、筛选(用户指出保留/删除/合并,并给出简要理由)、缺口检查、起草、迭代细化。从未知最多的部分开始(通常是核心决策/提案),总结部分留到最后。文章结构清晰时询问从哪部分开始;用户不知道需要哪些部分时,基于文档类型和模板建议 3-5 个部分。创建初始文档结构,所有部分带占位文本。若可用 artifacts,使用 create_file 创建 artifact;否则在工作目录创建 markdown 文件。编辑使用 str_replace,从不重印整个文档。用户直接编辑文档并要求读取时,会记住其更改以理解其偏好。

  3. 读者测试(Reader Testing):用全新的 Claude(无上下文)测试文档,验证它对读者有效。可访问子智能体时(如 Claude Code 中)直接测试:预测读者问题(5-10 个)、用子智能体测试每个问题、运行额外检查(歧义、错误假设、矛盾)、报告并修复。无子智能体访问时(如 claude.ai 网页界面),用户需手动测试:打开全新 Claude 对话 https://claude.ai,粘贴或分享文档内容,向 Reader Claude 提问,并询问文档中可能对读者模糊不清的内容、假设读者已具备的知识、内部矛盾或不一致。退出条件:当 Reader Claude 持续正确回答问题且不产生新缺口或歧义时,文档就绪。

使用方式

触发条件包括用户提及撰写文档或特定文档类型。初始提供时会解释三个阶段,并询问用户想尝试此工作流还是偏好自由形式。用户拒绝则自由形式工作;用户接受则进入阶段 1。

适用场景

适用于协作撰写各类文档,包括技术规格、决策文档、提案、PRD、设计文档、RFC 等。

限制

集成可用性取决于环境;无子智能体时读者测试需用户手动完成。编辑使用 str_replace,artifacts 不用于头脑风暴列表。