| name | plan |
| description | 用于写作和执行单文件 plan.md。适用于中大型开发、跨模块重构、生产级验收、恢复演练、架构硬化、评测闭环,以及任何不能靠一次小补丁完成的任务;要求把 plan.md 写成需求、事实、失败测试、目标、设计、任务、验证和收口合一的规格驱动执行合同。 |
Plan
plan.md 是单文件规格驱动执行合同。
它同时承担需求文档、当前事实、失败测试、目标合同、设计合同、实施任务、验证计划和收口记录。
没有完整 plan.md,不做大改。
执行中发现事实推翻计划,先更新 plan.md,再继续。
写作顺序
必须按这个顺序写 plan.md:
- 需求文档。
- 当前事实。
- 失败测试。
- 目标。
- 不做范围。
- 设计。
- 实施任务。
- 验证计划。
- 收口。
执行规则
- 写完计划,再动手。
- checklist 必须随进度更新。
- 新事实推翻计划,先改计划,再继续。
- 不用口头解释替代计划更新。
- 不偷偷偏离计划。
- 不把旧能力、旧状态、旧数据写成当前产品事实。
- 不为了简短牺牲边界、失败测试和验证。
- 提出一个方向后,要把 research、设计、实现、测试、文档同步、验证和收口做成完整闭环。
- 不把方向拆成反复让 owner 推动的小步。除非遇到客观阻塞,否则同一方向做到可交付、可验证、可长期保留。
标准模板
# [任务名] Plan
## 1. 需求文档
## 2. 当前事实
## 3. 失败测试
## 4. 目标
## 5. 不做范围
## 6. 设计
## 7. 实施任务
## 8. 验证计划
## 9. 收口