doc-coauthoring – 文档协同编写 Skill

Skill 详细介绍

anthropics/skills#doc-coauthoring 是 Anthropic 官方 Skills 仓库中的一个 Skill，名称为 doc-coauthoring，作者/组织为 Anthropic。它属于 Anthropic 官方发布的 Agent Skill 集合，核心用途围绕“文档共创”——让 AI Agent 与用户一起协作撰写、整理和打磨文档，而不是替用户一次性生成一份成品、丢给用户就结束。

它是什么

• 一个面向“人机协作写作”的工作流型 Skill / 指令集。
• 让 Agent 在文档创作过程中扮演共同作者的角色：理解需求、搭结构、起草、迭代、修改。
• 本质是一组关于文档共创过程的指令与方法论，而不是一个可以独立运行的软件、服务或 CLI。

它不是什么

• 不是独立安装、独立运行的应用程序。
• 不是特定排版工具（如 Word、LaTeX）的插件。
• 不是托管的在线文档服务，也不自带云端存储。
• 不是取代用户判断的“全自动写作机器人”。

主要解决什么问题

普通 Agent 处理长文档时容易出现两个问题：一是无视用户意图直接输出整篇，二是反复返工、上下文丢失。doc-coauthoring 的价值在于把“写文档”拆成可协作的过程——先对齐目标与结构，再逐步成稿，让用户在每个阶段可介入、可修改。它适合把 Agent 从“一次性输出”调整为“过程式共创”。

核心能力

• 与用户一起确定文档目标、受众、范围。
• 协商文档结构（大纲、章节顺序）。
• 分阶段起草，而非一口气写完整篇。
• 根据用户反馈迭代、修改、润色。
• 在共创过程中管理上下文，保持前后一致。

它和普通 Agent 自身能力的区别

普通 Agent 也能写文档，但通常缺少一套稳定的协作流程。doc-coauthoring 提供的正是这套流程的约束与引导，使不同会话、不同文档都能按相近的协作方式推进。它本身不是模型能力升级，而是对 Agent 行为的流程化组织。

适合的用户

• 需要撰写长文档、报告、方案、说明书的用户。
• 希望与 Agent 反复迭代而非一次成稿的用户。
• 需要结构化协作流程来约束 Agent 输出的用户。

不适合的需求

• 只想要“一句话生成一篇完整文章”的快速输出。
• 需要特定行业排版模板或出版级排版的需求。
• 把它当成独立写作软件使用。

关于该 Skill 的具体指令细节、内部工作流步骤与精确功能列表，请以 Anthropic 官方仓库中当前的 SKILL.md 为准。本文基于其名称、所属官方 Skills 仓库定位以及“文档共创”这一明确用途进行说明，不对官方未公开的内部实现细节作推测。

Skill 安全评估

总体判断：来自 Anthropic 官方 Skills 仓库、以文档共创为核心的流程型 Skill，其行为面相对可控，主要风险来自“你让它写什么、改什么文件”，而不是它自身携带的独立攻击面。

来源可信度

• 来源为 Anthropic 官方 Skills 仓库，作者/组织可信度高。
• 与来源不明的第三方同名项目相比，官方来源版本更值得优先选择。
• 请以官方仓库当前版本为准，避免使用来路不明的镜像、Fork 或二次发布版本。

权限面（可能涉及）

• 文件读取：如果用于修改已有文档，Agent 需要读取文件内容。属于符合用途的必要权限。
• 文件写入：共创过程会产生新文档或修改现有文档。属于符合用途的必要权限。
• Shell：纯写作场景通常不需要。若 Agent 用 Shell 进行文件操作，属于可选能力，可关闭。
• 网络：如果文档涉及联网查资料，可能涉及。属于可选，可关闭。

需要注意的点

• 文档可能包含敏感信息。让 Agent 读取/写入的目录应限定在必要范围内。
• 如需修改已有重要文档，建议先备份或使用版本控制，避免误覆盖。
• 如果关闭自动执行 Shell 权限，只让 Skill 生成和修改文本，风险会进一步降低。
• 不要在文档中放入会被 Skill 一并处理的凭证、密钥、Token 等敏感字段，除非确有必要并清楚其风险。

说明：本文不声称已对该 Skill 完成任何形式的安全审计，也不掌握官方安全扫描结论。上面的判断基于 Skill 的用途类型和来源可信度，供参考。

Skill 使用要求

这一部分只说明“用起来需要准备什么”。

一、Agent / 客户端

该 Skill 来自 Anthropic 官方 Skills 仓库，与 Claude Code 适配度最高，优先在 Claude Code 中使用。官方没有公布完整的第三方 Agent 兼容列表。从 Agent Skill 的通用工作方式来看，在支持 Skills、自定义 Skill 或类似指令加载机制的环境中，通常也可以尝试在 Codex、Cursor、Trae、OpenClaw、WorkBuddy 等主流 AI Agent 中使用，但不同 Agent 的 Skill 加载方式和兼容程度可能不同，具体以对应 Agent 当前版本为准。

二、运行环境 / 依赖

• Skill 本体是流程/指令型，不依赖特定运行时即可被 Agent 加载。
• 如果 Agent 本身需要 Node.js、Python、Git 等环境，那是 Agent 运行所需，不是本 Skill 单独提出。
• 官方未明确给出该 Skill 的专用版本依赖，具体以官方仓库当前说明为准。

三、权限

• 文件读取：可选（读取待修改文档时需要）。
• 文件写入：可选（生成或修改文档时需要）。
• Shell：可选，非必需。
• 网络：可选，非必需。

四、账号 / API Key

doc-coauthoring 本身是文档共创流程，不涉及它自己的账号、API Key 或 Token。是否需要这些凭证，取决于你所使用的 Agent（如 Claude Code 的登录 / 额度机制），以及你后续要写的文档内容——这与 Skill 本身无关。

最小使用条件

• 一个支持 Skill / 自定义指令加载的 Agent（Claude Code 优先）。
• 本页面提供的 Skill 安装指令。
• 需要修改本地文档时，授予相应目录的读写权限。

Skill 安装、使用与卸载教程

一、安装

可以直接复制本页面提供的 Skill 安装指令，粘贴到对应的 Agent 或终端执行。LemonAIKit 的 Skill 详情页已经单独提供了安装指令，这里不重复完整命令。

如果你不确定自己的 Agent 如何安装，直接问当前 Agent 更稳妥，例如：

如何安装 anthropics/skills#doc-coauthoring？

如何在 Claude Code 中安装 anthropics/skills#doc-coauthoring？

如何在 Codex 中安装 anthropics/skills#doc-coauthoring？

如何在 Cursor 中安装 anthropics/skills#doc-coauthoring？

让 Agent 根据它自己的 Skill 加载 / 管理机制指导安装。不同 Agent 的 Skill 目录和加载方式不同，不要照搬其他 Agent 的安装路径。

二、安装后如何使用

安装后，在需要共创文档的任务里直接描述需求，Agent 就会按 doc-coauthoring 的流程与你协作，而不是一次性输出整篇。

自然语言示例：

用 doc-coauthoring 帮我写一份公司内部 API 使用规范文档，先帮我把结构和大纲理出来，我们一步步来。

使用 doc-coauthoring，我要写一份年度项目总结报告，你先问我几个关键问题，然后我们一起定结构和内容。

用 doc-coauthoring 帮我改写这份产品需求文档，逐段讨论，不要一次改完。

上面的示例是自然语言请求，不是官方 CLI 命令，也不是官方 Slash Command。

三、卸载

卸载保持简单：优先使用对应 Agent / Skill 管理器提供的删除方式，移除该 Skill 即可。如果找不到统一卸载命令，最省事的方法是直接询问当前 Agent：

如何卸载 anthropics/skills#doc-coauthoring？

不同 Agent 的 Skill 安装位置和管理方式不同，如果没有统一卸载命令，以当前 Agent 的说明为准更稳妥。官方未在本 Skill 层面公布专用卸载命令。

常见问题

1. 它可以同时安装到多个 Agent 吗？

通常没有硬性限制。但每个 Agent 各自管理自己的 Skill 目录，需要分别安装、分别验证是否加载成功。

2. 安装后 Agent 没识别到这个 Skill，可能是什么原因？

常见原因有：安装到了 Agent 未扫描的目录、Skill 名称或路径写错、Agent 需要重启或重新加载、当前 Agent 版本不支持该 Skill 加载机制。先确认安装位置是否被 Agent 识别，再重启或询问 Agent 是否已加载 doc-coauthoring。

3. Skill 更新后需要重新安装吗？

取决于你的 Agent 如何管理 Skill。有些方式会在加载时读取最新版本，有些需要手动更新。以官方仓库当前版本和对应 Agent 的说明为准，不确定就直接问 Agent。

4. 它会不会擅自修改我已有的文档？

写入与否取决于你是否授予文件写入权限，以及你如何描述任务。如果只需要它给建议而不改文件，可以明确说明“只输出内容，不要写入文件”，或关闭文件的自动写入权限。对重要文档，建议先备份或纳入版本控制。

5. 中国大陆使用是否有网络要求？

Skill 本体是流程/指令型，本地加载通常不依赖联网。是否联网取决于你的 Agent 和文档任务本身（例如是否需要查资料）。如果走 Anthropic 官方服务，可能受当前网络环境影响，具体以你实际使用的 Agent 和服务为准。

6. 它和普通的“让 AI 写文档”有什么区别？

普通方式偏向一次性输出；doc-coauthoring 强调过程协作——先对齐目标、再定结构、分阶段起草和修改。它适合需要反复迭代、需要人参与的文档任务，不适合只想要一句话成稿的场景。

7. 适合用在生产环境或正式文档吗？

可以作为正式文档的协作与起草工具，但最终内容仍需人工审核。它提供的是流程约束，不保证内容准确性。重要文档建议在人工审阅后再定稿。