前言¶

技术文档、提案和决策说明往往不是「一次 prompt 出全文」就能交稿。背景散落在频道和会议纪要里，作者脑子里清楚、读者却看不懂，定稿前也很少有人用「陌生读者」视角做验证。直接在对话里让模型自由发挥，容易漏约束、章节失衡，或写出对作者有意义、对他人却含糊的段落。

下面介绍 SkillHub 上的 文档协作撰写工作流（@org-02qudk26/doc-coauthoring）。它把协作写作拆成可重复的步骤：先对齐上下文，再按章节迭代起草与打磨，最后用读者测试检查盲点。适合在 Cursor、Claude Code 等支持 Agent Skills 的环境里启用。

这是什么¶

文档协作撰写工作流 是一条面向 Agent 的结构化指引（通用 SKILL.md 格式），由 智雨科技 发布，版本 1.0.0，分类为 content-creation，来源标注为 enterprise。坐标为 @org-02qudk26/doc-coauthoring；SkillHub 页面显示评分 100000，下载约 1592 次，标签 requires_api_key=false（无需额外 API Key）。

官方简介：引导用户走完结构化的文档协作撰写工作流；当用户想撰写文档、提案、技术规格、决策文档或类似结构化内容时使用；帮助高效传递上下文、通过迭代打磨内容，并验证文档对读者是否有效。

与「单次生成长文」相比，该 Skill 要求 Agent 充当引导者，按阶段推进，并在用户拒绝流程时退回自由撰写。

核心功能¶

以下能力均来自技能包内的 SKILL.md 说明。

触发与入口¶

当用户提到写文档、起草提案、创建规格，或出现 PRD、设计文档、决策文档、RFC 等类型时，Agent 应说明三阶段流程并询问是否采用；用户拒绝则按自由形式写作。

阶段 1：上下文收集¶

1. 先问文档类型、受众、期望影响、模板或格式、其他约束。
2. 鼓励用户倾倒背景（项目背景、备选方案、组织上下文、依赖、干系人等）；若有 Slack、Drive 等集成则尝试拉取，否则提示粘贴或配置连接器。
3. 在用户完成初步倾倒后，提出约 5–10 条澄清问题；理解足够深入后，再进入起草。

阶段 2：打磨与结构¶

1. 按文档类型建议章节，或让用户选定顺序（通常从「未知数最多」的章节开始，摘要可后置）。
2. 建立带占位符的全文脚手架（支持制品时用 create_file；否则在工作目录写 Markdown，如 technical-spec.md）。
3. 对每个章节循环：澄清问题 → 头脑风暴 5–20 条要点 → 用户筛选保留/删除/合并 → 空白检查 → 用 str_replace 起草并迭代修改（避免整篇重印）。
4. 多数章节完成后，通读全文检查流畅性、冗余与矛盾；全部章节满意后，可进入读者测试。

阶段 3：读者测试¶

目标是用「无本对话上下文」的读者视角检验文档。

• 有子 Agent 的环境（如 Claude Code）：由 Agent 生成读者可能问的问题，用子 Agent 仅依据文档作答，并检查歧义与矛盾；发现问题则回到阶段 2 修订。
• 无子 Agent 的环境：指导用户在新对话中粘贴文档并提问；根据 Reader 是否答对、是否误解来迭代。

读者测试稳定通过且无明显新盲点时，流程结束；Skill 建议作者自行核对事实、链接与技术细节，并对文档质量负责。

安装与启用¶

先确认本机已安装 SkillHub CLI（参见 SkillHub 安装说明）：

command -v skillhub && skillhub --version

未安装时可执行官方推荐的一键安装（需联网）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

安装技能时，必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。本 Skill 的安装命令为：

skillhub install doc-coauthoring --namespace org-02qudk26 --dir <你的 skills 目录>

常用客户端路径（来自 SkillHub 安装文档）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

也可将安装提示直接发给 Agent：「请根据 https://skillhub.cn/install/skillhub.md，安装 @org-02qudk26/doc-coauthoring。」安装后按各客户端要求刷新或重启 Agent，使技能生效。

典型用法¶

1. 用自然语言触发¶

在已启用该 Skill 的对话中，说明文档类型与目标即可，例如：

• 「帮我写一份技术规格，受众是后端团队。」
• 「起草一个是否引入某中间件的决策文档。」
• 「按 RFC 形式整理这次 API 变更。」

Agent 应主动介绍三阶段流程并征求是否采用。

2. 配合章节迭代¶

接受工作流后，按 Skill 要求用简写回答元问题与澄清列表（如「1: 是，2: 见 #channel，3: 否」）。进入阶段 2 后，对头脑风暴列表用「保留 1,4,7 / 删除 3 / 合并 11 和 12」等方式筛选，比直接改全文更利于 Agent 学习你的取舍。

3. 读者测试¶

在 Cursor 等若无内置「子 Agent 读者」，按 Skill 指引新开对话，仅粘贴成稿并提问；把答错或含糊之处反馈给原对话，回到对应章节打磨。

技能包 README.md 中给出的示意场景包括：复杂迁移提案需先收集约束再排章节、产品规格需补足术语后做读者测试、投资决策需整理目标、证据、选项与风险等——可作为选题参考，实际内容仍以你的业务材料为准。

适用场景与注意¶

适合谁

• 需要写提案、技术规格、决策文档、PRD、设计文档、RFC 等结构化文稿的工程师、架构师、产品与技术负责人。
• 希望把「背景收集 → 分节起草 → 读者可读性验证」固化到 Agent 行为里，而不是每次重新描述流程的团队。

限制与注意

• 流程偏长，Skill 本身允许用户跳过阶段或改用自由撰写；时间紧时要主动说清期望。
• 文中部分步骤针对 Claude 制品（artifact）与子 Agent；在 Cursor 中通常落为工作区 Markdown 文件与 str_replace 编辑，读者测试需手动或借助其他 Agent 能力完成。
• 外部文档、频道内容依赖 MCP/连接器；无集成时需自行粘贴上下文。
• SkillHub 统计的下载量会变动，以 SkillHub 技能页 为准。

结尾¶

文档协作撰写工作流 把结构化写作拆成上下文收集、按章打磨与读者测试三步，减少「作者默认读者已知」带来的误解，并强调用增量编辑而非整篇重写。若你经常在 Agent 里写规格或决策类文档，可以按上文命令安装到对应 skills 目录后试用。

官方入口：

• SkillHub 页面：https://www.skillhub.cn/skills/org-02qudk26/doc-coauthoring
• API 坐标页：https://api.skillhub.cn/org-02qudk26/doc-coauthoring