1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | doc-coauthoring-anthropics-skills | — |
| 项目自述名称 | doc-coauthoring（SKILL.md 内 name 字段） |
SKILL.md |
| 作者/维护者 | Anthropic（anthropics/skills 官方仓库） |
GitHub API |
| 来源链接 | https://github.com/anthropics/skills/tree/main/skills/doc-coauthoring | — |
| 许可证 | 未在该子目录内提供独立 LICENSE.txt（同仓库多数其他 skill 均含有）；仓库 README 仅笼统声明“部分 skill 为 Apache 2.0 开源”，未明确本 skill 是否在列，GitHub 也未识别出仓库级 license | GitHub API + 仓库文件核查 |
| GitHub Stars / Forks | 所属合集仓库 160,855★ / 18,977 forks（合集仓库 stars 不计给单个 skill，见第 6 章说明） | GitHub API |
| 最新版本 | 无独立版本号；本子目录 2025-12-04 由 PR #134 新增，2026-04-20 随仓库全量 License 文案修订一并触碰 | GitHub API（commits） |
| 安装方式 | Claude.ai 付费版内置可用；或 Claude Code 插件市场安装；或 npx skills add |
官方 README |
2. 功能介绍与亮点
doc-coauthoring 提供结构化的“人机协作写作”工作流，解决“从零散上下文到一篇经得起推敲的文档”这一痛点，覆盖技术规范、决策文档（decision doc）、提案（RFC/PRD）等场景。工作流分三阶段：
- 上下文收集：先问文档类型/受众/期望影响/模板/约束，引导用户“信息倾倒”（可接 Slack/Google Drive 连接器拉取背景），再生成针对性追问，弥合“用户已知”与“Claude 已知”的落差
- 逐节精炼：按“提问→头脑风暴要点→用户圈选保留/删除/合并→起草→手术式修改”循环逐节产出，用
str_replace精确编辑而非整篇重写 - 读者测试：拉起一个没有对话上下文的全新 Claude 实例，用预测的读者提问“盲测”文档能否被独立理解，发现歧义即回炉重写——Claude Code 下由 sub-agent 自动完成，claude.ai 网页版引导用户手动完成
亮点：官方出品、Claude.ai 付费版零安装即用；“读者盲测”是同类写作 skill 中少见的质量闭环，不依赖作者自我感觉，而是用独立实例模拟真实读者校验；纯提示词实现，无脚本无依赖，天然跨环境可移植。
3. 适用场景
固定分类：内容创作与知识管理
- 需要撰写技术规范（spec）、设计文档、决策文档（decision doc）、RFC 或产品提案（PRD）的工程师与产品经理
- 面对“脑子里想法很多但不知道怎么组织成一篇文档”困境的初中级用户
- 需要把团队内部零散讨论（Slack 消息、会议纪要）转化为结构化文档的团队协作者
- 希望在文档发布前先做“读者视角”校验、减少后续来回澄清成本的写作者
4. 跨 Agent 兼容性
- Claude Code：原生支持——官方仓库直接提供插件市场安装，触发条件为用户提及“写文档/提案/规范”等意图
- Codex：未验证具体到本 skill——但 SKILL.md 遵循的开放 Agent Skills 规范，据发现阶段检索到的资料显示已被 OpenAI Codex、Cursor、Gemini CLI 等环境采纳为通用格式，理论上可迁移使用
- OpenClaw：未验证——抓取材料中未提及
- Hermes Agent：未验证——抓取材料中未提及
（仅基于已抓取材料判断，未为兼容性单独发起搜索）
5. 推荐理由
多数写作类 AI 工具止步于“根据一次性 prompt 生成一篇文档”，质量高度依赖用户给出的上下文是否完整。doc-coauthoring 把写作拆解成“收集上下文—逐节共创—读者盲测”三阶段，尤其是“用没有记忆的全新 Claude 实例反向测试文档能否被独立理解”这一设计，直接命中技术文档最常见的失败模式——作者视角的“知识诅咒”。已有独立开发者博客证实将其用于灾难恢复计划、多份技术规范与新人上手指南，且“每次产出都愿意署名”（见第 8 章）。对于常写规范文档却无人 review 的初中级用户，这是能显著提升文档质量下限的免费官方工具。
6. 评分
| 维度 | 分数 |
|---|---|
| 受欢迎程度 | 9 |
| 可用性 | 8 |
| 安全性 | 9 |
| 综合评分 | 8.7 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令执行 | 无——整个 skill 仅一份 SKILL.md 提示词文件，无脚本、无代码执行 |
| ② 运行时联网外发 | 无主动外联；仅在用户明确要求且环境已配置 Slack/Google Drive 等连接器时，通过用户自己已授权的集成读取指定内容，不涉及未经同意的数据外发 |
| ③ API key/凭据 | 不要求任何凭据；涉及的第三方集成凭据均为用户自有 Claude 环境的既有授权，非本 skill 引入 |
| ④ 可疑指令 | 抓取的完整 SKILL.md 全文未见 prompt injection 或隐藏指令迹象，指令均为面向用户的写作流程引导 |
| ⑤ 作者信誉 | Anthropic 官方仓库，信誉最高档 |
| ⑥ License | 该子目录未附独立 LICENSE.txt（同仓库 internal-comms、algorithmic-art 等大多数 skill 均有），仓库整体也未被 GitHub 识别出统一 license，条款透明度弱于同仓库其他子技能 |
| ⑦ 维护时间 | 2025-12-04 新增，2026-04-20 随仓库全量提交触碰（本次运行前 85 天内），维护尚属活跃 |
安全性未给满分的原因：⑥ License 条款不如同仓库其他子技能清晰，商业二次使用边界未明确声明。
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 来源 | 受欢迎程度证据 | 目标场景 |
|---|---|---|---|---|
| doc-coauthoring（本次推荐） | 三阶段人机共创写作 + 读者盲测闭环 | anthropics/skills 官方 | 官方出品；独立博主实测证实用于 DR 计划/技术规范 | 写技术规范、决策文档、提案的工程师/PM |
| internal-comms | 内部沟通稿模板集（周报、Newsletter、FAQ） | anthropics/skills 官方（同仓库不同子目录） | 官方出品 | 需要按公司惯用格式写内部通讯的员工 |
| theme-factory | 给已完成的文档/幻灯片套用预设视觉主题 | anthropics/skills 官方（同仓库不同子目录） | 官方出品 | 需要美化产出物视觉风格的用户 |
| academic-research-skills | 学术文献检索与研究笔记整理 | imbad0202/academic-research-skills（第三方） | 第三方独立项目 | 做文献综述、学术研究的用户 |
| doc-coauthoring 全网同类第三方聚合仓库（如 alirezarezvani/claude-skills 内的写作类子技能） | 数百个技能打包集合中的写作模板之一 | 第三方大型 monorepo | 集合仓库层面 5,200+★，但单个写作子技能无独立热度数据 | 需要“一揽子”技能库的用户 |
差异化：internal-comms、theme-factory 虽同属官方出品，但分别聚焦“套公司模板的内部通讯”与“给成品套视觉主题”，不解决“从零散想法到经得起读者检验的结构化文档”这一核心问题；academic-research-skills 定位偏学术检索；第三方聚合仓库虽收录类似模板，但缺少“读者盲测”式质量校验，且合集热度无法归因到具体子技能。doc-coauthoring 是候选中唯一把“上下文收集—协作起草—独立验证”做成完整闭环的选项。
8. 用户评价
以下 1 条评价为亲自抓取验证：
- 独立开发者（welcomedeveloper.com 博客《The 10 Claude Code Skills I Actually Use at Work》作者，自述在基础设施团队工作）：将其用于“基础设施文档、运行手册、灾难恢复计划、规范与 API 文档”，评价流程“转移上下文、建立大纲、获得结构认可后逐节起草”，产出“读起来像人写的”，并表示“每次结果都是我愿意署名的东西”。
预算内仅验证到以上 1 条；其余页面（如 coldiq.com、skills.rest）抓取核实后均为 SKILL.md 的自动化转载而非独立评价，本次未收集到更多真实用户评价，不为凑数追加抓取。
9. 其他补充
- 无需付费依赖或第三方 API：核心工作流完全基于 Claude 自身能力（含 Claude Code 环境下的 sub-agent 调用）完成“读者盲测”
- 与 Slack、Google Drive、SharePoint 等 MCP 连接器兼容，可在上下文收集阶段直接读取既有讨论，但并非必需——无集成时同样可通过用户手动粘贴内容完整走完流程
10. 安装使用方式
- Claude.ai 付费版用户：已随 Anthropic 官方 example skills 内置可用，涉及写文档意图时自动触发
- Claude Code 用户：
/plugin marketplace add anthropics/skills后/plugin install example-skills@anthropic-agent-skills（该插件包含 doc-coauthoring 及另外 11 个官方示例 skill） - 其他支持 Agent Skills 规范的环境：
npx skills add https://github.com/anthropics/skills --skill doc-coauthoring - 安装后无需重启；用户提及“写文档 / 起草提案 / 写规范 / 写 RFC”等意图时自动触发引导，也可直接要求 Claude 使用该工作流
11. 注意事项
- 该子目录缺少独立 LICENSE.txt，若计划将其工作流内容二次分发或商用，建议先向 Anthropic 确认具体授权条款，而非直接套用仓库 README 里“部分 skill 为 Apache 2.0”的笼统表述
- 完整走完三阶段流程（尤其是逐节精炼与读者盲测）比直接一次性生成文档耗时更长，更适合“值得反复打磨”的中长篇正式文档，简单便签、临时消息类写作没必要套用整套流程
- 读者盲测阶段在 Claude Code（有 sub-agent 能力）与 claude.ai 网页版（需用户手动开新对话测试）体验不同，网页版用户需要额外操作步骤才能获得同等质量校验
- 与 Codex / OpenClaw / Hermes Agent 的兼容性未经本次验证，实际可用性需自行测试