1实现原理 · 为什么它能做到
宣称的「引导共创」不靠任何代码，而是纯 prompt 编排：模型以 active guide 角色按三段式交互协议（Context Gathering / Refinement & Structure / Reader Testing）驱动用户，能力完全由结构化对话指令实现
doc-coauthoring/SKILL.md:L8
This skill provides a structured workflow for guiding users through collaborative document creation. Act as an active guide, walking users through three stages: Context Gathering, Refinement & Structure, and Reader Testing.
全 skill 只有一份 SKILL.md（git ls-files doc-coauthoring/ 仅返回该文件），无脚本/引用/模板。这里是「为什么能实现」：把文档共创编码成可执行的对话协议，而不是靠外部工具链。
Stage 1 先把「用户脑内知识」搬进对话上下文：5 个元问题 + 鼓励自由倾倒 + 按缺口生成 5-10 条澄清问题，并用可判定的退出条件防止过早开写
doc-coauthoring/SKILL.md:L30
**Goal:** Close the gap between what the user knows and what Claude knows, enabling smart guidance later.
补充证据：L34-40 五个元问题；L92-94「Generate 5-10 numbered questions based on gaps in the context.」；L97「Sufficient context has been gathered when questions show understanding - when edge cases and trade-offs can be asked about without needing basics explained.」——退出条件把「理解到位」操作化，这是后续每节 5-10 问都能问在点子上的前提。
Stage 2 把起草拆成每节固定 6 步（澄清→头脑风暴 5-20 项→编号策展→缺口检查→起草→迭代），用「数字编号取舍」协议把用户的含糊反馈变成可执行指令
doc-coauthoring/SKILL.md:L168
Generate 5-20 numbered options based on section complexity. At the end, offer to brainstorm more if they want additional options.
补充证据：L175-179 策展示例「Keep 1,4,7,9」「Combine 11 and 12」；L183-184 gap check。编号协议让模型能稳定消费用户反馈，并顺势学到「该保留什么」的优先级。
起草与迭代全程走宿主编辑工具（create_file 建 artifact 骨架 / str_replace 做手术刀式编辑），刻意「never reprint the whole doc」，避免长文档逐次全量重写造成的漂移
doc-coauthoring/SKILL.md:L208
- Use `str_replace` to make edits (never reprint the whole doc)
补充证据：L135「Use `create_file` to create an artifact. This gives both Claude and the user a scaffold to work from.」；L148（无 artifact 宿主时）「Create file with all section headers and placeholder text.」。skill 按宿主能力自动选路：有 artifact 用 create_file + 每次改完给链接，否则落本地 markdown 文件。
Stage 3 Reader Testing 是该 skill 最独特的机制：用「零上下文的新 Claude 子代理」模拟真实读者，验证文档脱离作者语境后仍自洽——把『读者视角』变成可自动执行的检查
doc-coauthoring/SKILL.md:L244
**Goal:** Test the document with a fresh Claude (no context bleed) to verify it works for readers.
补充证据：L265「For each question, invoke a sub-agent with just the document content and the question.」；L273 子代理再查 ambiguity/false assumptions/contradictions；失败则「Loop back to refinement for any problematic sections.」（L325）。无子代理环境（claude.ai web）退化为给用户手动测试指引：开新会话 https://claude.ai 粘贴文档（L303-304）。
用户主权贯穿全程：开头可拒、中途可跳、随时可退回 freeform，流程只做引导不绑架，且有明确的『用户拥有文档』边界
doc-coauthoring/SKILL.md:L26
If user declines, work freeform. If user accepts, proceed to Stage 1.
补充证据：L358「If user wants to skip a stage: Ask if they want to skip this and write freeform」；L360「Always give user agency to adjust the process」；L338 收尾要求用户自己终读负责（they own this document and are responsible for its quality）。
2核心能力
01文档任务触发识别 + 三阶段流程主动 offer（含 freeform 拒绝路径）
02Stage 1 上下文采集：5 元问题 → 自由 info dump → 按缺口生成 5-10 条澄清问题（支持 shorthand 回答）
03文档脚手架生成：有 artifact 用 create_file，无则在工作目录建占位 markdown（decision-doc.md / technical-spec.md 等）
04分节六步共创协议：澄清问 → 5-20 项头脑风暴 → 编号策展 → 缺口检查 → str_replace 起草 → 迭代
05风格学习回路：要求用户『指出要改什么』而非直接编辑，模型据此学习其偏好用于后续章节
06收敛质量门：连续 3 轮无实质改动即问可否删减；完成 80%+ 后全篇复查 flow/冗余/矛盾/slop
07Reader Testing 双路径：Claude Code 用子代理自动测 / claude.ai web 给用户手动测试脚本，失败章节回炉精修
08收尾后处理：作者终读负责、链接共创对话进附录、文档随真实读者反馈持续更新
3外部依赖
| Kind | Dependency / Endpoint |
|---|---|
| api | create_file（宿主内建 artifact 工具，非外部 API） |
| api | str_replace（宿主内建编辑工具，非外部 API） |
| api | sub-agents（Claude Code 运行时能力，非外部 API；skill 未指定具体 task 工具名） |
| api | 集成连接器 Slack/Teams/Google Drive/SharePoint/MCP 服务器 —— 条件性：仅在『If integrations are available』时提及，由宿主提供、无绑定端点 |
| network | claude.ai —— 仅作为用户手动 Reader Testing 的文字入口（用户自行打开新会话，skill/agent 不发起网络调用） |
4管控建议与判定依据
建议配套管控措施
面向 Agent
限定工作目录
面向管理者
保留操作记录
判定依据（文件路径与关键语句摘要）
- 本地工作目录: 文件读写与工件输出: 对共创文档执行 str_replace 编辑 —— SKILL.md L188/L208
审计说明： 纯指令、无脚本、无网络外发、无凭证读取；但 skill 明确指示宿主做本地文件写入（L148 建骨架文件、L188/L208 str_replace 编辑用户文档），按风险范式『仅本地读写、无网络外发、无凭证』落 🔵 蓝档『知晓即可』。写入对象始终是用户经对话逐步确认要共创的文档本体，无隐蔽行为。
5第二遍独立确认
- [ok] 目录内仅 SKILL.md、无脚本/引用/模板等资源 — git ls-files doc-coauthoring/ 只返回 doc-coauthoring/SKILL.md
- [ok] description 引用逐字一致 — L3 原文与 meta.official_desc 完全一致
- [ok] create_file / str_replace 调用点真实存在 — L135、L188、L208、L367-368 均实存，且 L367-368 收尾 Tips 再次强调同一工具对
- [ok] claude.ai 网络提及 — 全文件唯一 http(s) 命中为 L303；L72/L290 仅文字提及 Claude.ai 产品名，无调用语义
- [ok] Slack/Teams/Google Drive/SharePoint/MCP 集成语 — L70 实存且为条件式（If integrations are available），属宿主能力提示而非 skill 自带 API
- [ok] sub-agent Reader Testing 机制 — L251-253（无需用户参与的自动路径）、L265、L273 实存，L290 起手动路径对照完整
- [ok] 无凭证读取 — grep api key/token/secret/password/credential/env/export/keychain 全文件零命中
- [ok] 无脚本执行面 — grep bash/python/subprocess/curl/wget/exec( 全文件零命中；SKILL.md 内无代码块
6结论
适合： 适合手头已有素材、想把 PRD/设计文档/决策记录/RFC 写成『脱离作者语境仍自洽、可被同事或 Claude 二次消费』的结构化文档的人；在 Claude Code（有子代理与 artifact）环境价值最大——Reader Testing 全自动。愿意做多轮问答与取舍的写作者获益最大。
不适合： 想要一步到位快速草稿或纯模板/示例的人；没耐心走问答-策展-迭代循环的人；文档内容高度机密、不愿全文离开当前对话（交给子代理或粘贴到 claude.ai）的场景。
Install Agent-Ready
① Verified Mirror 2026-09-06
Option A · Direct DownloadDownload doc-coauthoring.tar.gz
sha256:
Option B · Copy Guide for Agent930944490c8451b9…agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
② Upstream GitHub
GitHub Repo ↗
Pinned to commit 41bbe19d1a.