doc-coauthoring(Anthropic 官方文档共创)
Anthropic 官方文档共创引导 skill:通过「上下文收集 → 分节共创打磨 → 无上下文 Claude 读者测试」三阶段结构化流程,引导用户与 AI 协作写出对读者(包括未来把文档粘贴给 AI 的人)真正有效的 PRD、技术规格、决策文档,交付可用的文档而非空泛草稿。
仓库:anthropics/skills
热度证据:同上,协作编辑场景;官方 anthropics/skills 仓库 168,637 star,Claude Code 内置核心技能之一,全网被教程引用最多;awesome-claude-skills README 官方 Document C
五维评分
热度5/5
质量4/5
创新4/5
易用4/5
文档5/5
优秀点拆解
- 读者测试设计:用零上下文的 fresh Claude 子代理逐条验证预测的读者问题并查歧义/矛盾,把「文档质量」从主观感受变成可执行测试,且洞见到读者包括未来把文档粘贴进 Claude 的人
- 逐节共创六步微流程:澄清→头脑风暴5-20项→编号筛选带理由→缺口检查→起草→修订,切小粒度且用理由反馈学习用户优先级,实现越写越懂你
- 显式退出条件:Stage 1 以「能讨论边角案例而无需解释基础」、Stage 3 以「Reader Claude 持续答对」为推进标准,避免无限澄清与草草交差两个失败模式
- 工具纪律:create_file 建占位符骨架、str_replace 外科手术式编辑、永不整篇重印,token 高效且不破坏用户已认可内容
- 双环境自适应分支:SKILL.md 内写完整 If/Else 双路径(Claude Code 子代理自动测 vs claude.ai 手动测、有集成拉取 vs 无集成引导),一个 skill 两种产品形态都能工作
可复用的设计模式
- 引导式共创模式:agent 定位为 active guide 而非代笔者,把一次巨型生成拆成上下文收集→逐节共创→读者验证三段
- 新鲜读者测试(fresh-eyes testing):用无上下文的独立实例测产出物,可移植到 README、教程、SOP 等一切给人/给 AI 读的内容
- 编号选项+编号反馈交互协议:头脑风暴产出编号列表,用户报编号+一句理由,把反馈成本降到最低同时结构化学习偏好
- 占位符骨架+外科手术编辑:先建带 [To be written] 占位符的完整结构再逐节填充,编辑一律精确替换,防止重写丢失已确认内容
- 环境自适应降级分支:skill 内部按环境写双路径(有/无子代理、有/无集成),裸环境降级运行而非失效
适用场景
PRD、设计文档、决策记录、RFC、提案、技术规格等结构化文档的协作撰写会被多人反复阅读或粘贴给 AI 的高价值文档,需要发布前的读者视角质检跨团队写作:接 Slack/Teams/Drive/SharePoint 集成直接拉取团队上下文与历史讨论
边界与注意:纯流程型 skill 无脚本约束,执行质量依赖模型对指令的遵循度;三阶段流程交互成本高,不适合便签/邮件等快速写作;无集成环境下上下文拉取退化为用户手动粘贴。
完整拆解分析文档
本页为摘要版,完整精读分析(核心机制、逐条优秀点拆解、写作过程)见本地 Markdown 文档:
analysis/anthropics-doc-coauthoring.md