首页 / 全部技能 / 内容创作 / doc-coauthoring
English (EN)简体中文 (ZH)日本語 (JA)
内容创作 · anthropics/skills

doc-coauthoring

Guide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.

L2 本地 · 限定工作目录V1 已固定读写文件Dual-pass Audit
Author anthropicsGitHub anthropics/skills ↗Stars 174801License 未声明 —— doc-coauthoring/ 目录内无 LICENSE.txt（同仓 18 个 skill 中多数带 Apache-2.0 或 Anthropic 自定义 license），仓库根也无 LICENSE（gh api license 字段为 null）Commit 41bbe19d1a
管控等级描述 skill 的能力与建议配套的管控措施，不代表质量或安全认证，也不表示可用或不可用。是否使用由用户和管理者决定。不同 agent 宿主对权限的约束各不相同，请勿假定宿主一定会提供安全兜底。第三方 skill 版权归原作者，使用风险由使用者自行承担。

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外部依赖

KindDependency / Endpoint
apicreate_file（宿主内建 artifact 工具，非外部 API）
apistr_replace（宿主内建编辑工具，非外部 API）
apisub-agents（Claude Code 运行时能力，非外部 API；skill 未指定具体 task 工具名）
api集成连接器 Slack/Teams/Google Drive/SharePoint/MCP 服务器 —— 条件性：仅在『If integrations are available』时提及，由宿主提供、无绑定端点
networkclaude.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结论

  • 流程即产品：把文档共创拆成分节、可判定的交互协议（每节 6 步 + 退出条件），而非一次性的『给我写个文档』
  • Reader Testing 用零上下文 Claude 当真实读者试读，直击文档脱离作者语境后的可用性，是多数写作类 skill 没有的验证闭环
  • 风格学习回环：引导用户『指出要改什么』而非直接编辑，模型边改边学其偏好，后续章节越写越贴
  • 环境自适应双路径，Claude Code（子代理自动测试）与 claude.ai web（手动指引）都能完整跑通三阶段
  • 克制不越权：模型是引导者，文档所有权、终读与事实核对都明确留给用户，并内置反 slop 检查
    • 适合： 适合手头已有素材、想把 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: 930944490c8451b9…
    Option B · Copy Guide for Agent
    install.json
    agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
    ② Upstream GitHub
    GitHub Repo ↗
    Pinned to commit 41bbe19d1a.