Doc Coauthoring
协作文档写作流程:通过上下文收集、结构化迭代与读者测试三阶段,帮助快速完成高质量文档。
来源:基于 anthropics/skills(MIT)内容改写。
该流程适用于撰写规范、提案、PRD、RFC、决策文档等结构化内容。核心是让 Claude 扮演“协作编辑”,用三阶段把信息和表达逐步对齐。
触发场景
- 用户提到“写文档 / 写提案 / 写规范 / 写决策”
- 需要协作式整理背景与方案
- 文档读者不止本人(需要可读性验证)
阶段 1:上下文收集
目标:缩小“用户知道”和“Claude 知道”的差距。
建议询问:
- 文档类型(spec / PRD / RFC / 决策)
- 主要读者
- 期望读者读完后的行动
- 是否有模板或格式要求
- 其他限制或背景
鼓励用户一次性信息倾倒(可不整理),必要时拉取共享文档或聊天记录。如果有图片且无替代文本,提示补充说明。
当用户完成初步信息提供后,再提出 5-10 个澄清问题,补齐空白。
阶段 2:结构与迭代
目标:按章节逐步构建内容。
建议流程:
- 确认章节结构(或建议 3-5 个关键章节)
- 先建立框架(含占位文本)
- 对每一章依次执行:
- 澄清问题
- 5-20 个要点备选
- 选择/删改/合并
- 补缺口
- 产出初稿并做小范围精修
优先处理“最不确定的章节”,摘要建议最后写。
阶段 3:读者测试
目标:用“无上下文的 Claude”或“读者视角”检查盲点。
做法:
- 提供最终文档给“空白上下文”的助手
- 询问:是否看懂?是否缺信息?是否有歧义?
- 根据反馈回到第 2 阶段修订
快速清单
- 先问 5 个元问题,再鼓励信息倾倒
- 用 5-10 个澄清问题补齐空白
- 先搭框架,再逐段填充
- 每段:问问题 -> 选要点 -> 写草稿 -> 精修
- 最后进行“读者测试”
claudeskills文档