Anthropic 官方文档合著技能实测：先问 5 个问题再动笔，写提案、需求文档不用再一句话等全文，11 月 7 日实测版

Anthropic 官方技能仓库 anthropics/skills 里有个 doc-coauthoring 技能，专门管写文档这件事：提案、技术方案、决策文档都归它。它只有一个 SKILL.md 文件（约 1.6 万字符），没有脚本、没有钩子，算是比较安全的插件。用法不是一句话等全文，而是三段引导式对话：先收集背景，再逐节打磨，最后让一个全新的子代理只读文档、当一回读者挑毛病。

AI Parabellum 在 11 月 7 日用 Claude Code v2.1.318（macOS）实测了它：把 skills/doc-coauthoring 文件夹拷进演示项目的 .claude/skills，用 –setting-sources project 只在该项目里加载，不动个人配置。测试任务是写一份把待办工具从 tasks.json 迁到 SQLite 的决策文档。Claude 没有直接开写，先问了文档类型、读者、目标、模板、篇幅 5 个问题，又追问了 5 个跟项目相关的问题（比如并发写会不会丢数据、Python 内置 sqlite3 算不算零新依赖）。第二阶段它先搭了一个只有标题和占位符的 decision-doc.md，三节分别是问题与约束、方案与权衡、建议；然后对方案一节头脑风暴出 6 个选项——留 JSON 加文件锁、SQLite 单表、SQLite WAL 模式等等，由你挑、删、合并。

结论：适合认真写提案、需求文档、RFC 的人，结构从第一分钟就看得见，还会读你的代码替你回答问题；缺点是比一句话出稿慢，一个小节问了 8 个问题，一页纸的小文档用着有点重。第三阶段的读者测试作者这次没跑，介绍来自技能文件本身。安装有两路：官方技能仓库整包安（/plugin marketplace add anthropics/skills，再 /plugin install example-skills@anthropic-agent-skills），或者只拷 doc-coauthoring 一个文件夹更干净。之前发过的官方技能库安装总览和从零搭一个简历技能的实测可以对照着看。

来源：AI Parabellum，原文：https://aiparabellum.com/claude-doc-coauthoring-skill-write-better-docs/