模板
模板库
直接复制使用的文档模板
亲历产品组织阶段 · 通用更新于 2026-10-16
这里的 8 个模板覆盖从起步到运维的每个产物，每页都给出可以直接复制的完整正文，并说明每一节怎么填、最容易犯什么错。用法很简单：复制到仓库里约定的位置，删掉不适用的节，再让 Claude 和你一起把空填上。示例统一用“给待办应用加标签”这个通用功能。
模板一览
| 模板 | 什么时候用 | 放哪 | 命名 | 阶段 |
|---|---|---|---|---|
| 一页 CLAUDE.md | 建仓库的第一天，之后持续修剪 | 仓库根目录 | CLAUDE.md | 起步 |
| intent | 有了想法、工单或告警，动手之前 | spec 的第一节；线上问题回流时可以单独成文 | — | 规划 |
| spec | intent 确认之后、实质改动之前 | docs/specs/ | YYYY-MM-DD_<slug>.md | 设计 |
| plan | spec 确认之后、写代码之前 | docs/plans/ | YYYY-MM-DD_<slug>-plan.md | 开发 |
| ADR | 做了一个以后会被问“为什么”的决定 | 单仓 docs/adr/；跨仓放 ops 仓 decisions/ | ADR-NNN_<topic>.md | 设计 |
| 复盘 | 事故之后、项目结束、试用期满 | 单仓 docs/retros/；组织放 ops 仓 retros/ | YYYY-MM-DD_<event>.md | 运维 |
| REVIEW.md | 开始用 AI 审查 PR 的时候 | 仓库根目录 | REVIEW.md | 发布 |
| 子 agent 提示词 | 每次派子 agent 干活 | 不必存档；常用的整理进 playbook | — | 开发 |
<slug> 用小写英文加连字符，例如 todo-tags。同一个功能的 spec、plan、分支名用同一个 slug，agent 和 hook 都能按它找到对应文档。
填模板的三条规矩
- 模板是起点，不是表格。 删掉不适用的节，比硬填一句“无”强
- 具体到能检查。 “体验要好”没法验收，“一秒内显示”可以写成测试
- 改需求先改文档。 spec 和 plan 是活文档，实现中途发现要改，先改文档再改代码
这些模板之间的关系
一个功能的典型路径：intent 写在 spec 第一节，spec 确认后出 plan，按 plan 实现，PR 按 REVIEW.md 审查，上线后的问题写成复盘，复盘里的教训回流到 CLAUDE.md、hook 或新的 intent。实现阶段派子 agent 时，用子 agent 提示词模板交代任务。过程中做出的关键决定，单独写成 ADR。