| name | plan-breakdown |
| description | 任务归约拆分与验收标准前置。Use when 已有 Spec 或较清晰的需求、要把大需求切成可执行任务、准备启动开发之前。也适用于需求太大、一个 Agent 无法独立完成、需要拆成 Epic/Milestone/Issue 并定义 P0-P3 验收标准的场景。 |
Plan-Breakdown：归约拆分 + 验收标准前置
概述
承接 plan-spec 的 Spec，把需求从大到小逐层拆解，直到每个任务单元能被一个 Agent 独立完成；同时在创建时就写清每个 Issue 的 P0-P3 验收标准，并维护项目的 Plan Document。
核心原则： 任务足够小 + 标准前置不可回调。拆到位、标准定死，是后续高质量执行的地基。
何时使用
- 已有 Spec（来自 plan-spec），要开始拆任务
- 新 Milestone 启动 / 计划需要重新拆分
- 一个需求大到单个 Agent 无法一次做对
何时不用： 单个明确的小改动；需求尚未澄清（先用 plan-spec）。
流程
- 拆 Epic — 每个 Epic = 一个独立功能模块，先拆当前需要的 2-3 个。
- 拆 Milestone — 选第一个 Epic，拆出 Milestone，每个含：起始条件、交付物、验收标准。只细化前 1-2 个。用
templates/milestone-template.md。
- 拆 Issue — 选第一个 Milestone，拆到 Issue 级别。每个 Issue 含：任务描述、输入/输出、依赖条件、P0-P3 验收标准。用
templates/issue-template.md。
- 写验收标准（前置） — 拆 Issue 的同时按 P0-P3 分级写验收标准（见下表），让用户确认/调整。
- 维护 Plan Document — 把当前 Milestone 与 Issue 状态写入
PLAN.md（≤500 tokens），用 templates/plan-document-template.md。
Issue 粒度黄金法则
如果一个 Issue 需要 3 轮以上 review 才能合入，就是太大了，必须再拆。
P0-P3 验收标准分级
| 等级 | 含义 | 处理方式 |
|---|
| P0 | 阻塞性，不修复不能合入 | 必须修复 |
| P1 | 重要缺陷，本次合入前修复 | 必须修复 |
| P2 | 建议修复，可后续 PR | 记录为 follow-up issue |
| P3 | 锦上添花，可忽略 | 记录不追踪 |
原则：中途不允许降级。 做不完就拆 Issue，不降标准。
产出
- Epic / Milestone 列表（Milestone 用模板）
- Issue 列表（每个带 P0-P3 验收标准，用模板）
PLAN.md（≤500 tokens 的项目唯一真源）
提示词参考
基于这份 Spec 做任务拆分：先拆 Epic，再选第一个 Epic 拆 Milestone，最后选第一个 Milestone 拆到 Issue。每个 Issue 要含任务描述、输入/输出、验收标准（P0/P1/P2/P3 四级）、依赖关系。Issue 粒度不超过 3 轮 review。
常见错误
- 一次性把所有 Milestone/Issue 细节都拆完 → 浪费，且计划会变。只细化最近 1-2 个。
- Issue 过大 → 后续反复 review、token 浪费。按黄金法则及时再拆。
- 验收标准事后补 → 标准会被实现牵着走而滑坡。必须创建时前置写好。
- Plan Document 写成大杂烩 → 超出 500 tokens 就失去「快速对齐」价值。细节交给 Issue。
参考
- 模板：
templates/issue-template.md、templates/milestone-template.md、templates/plan-document-template.md
- 上一步：
skills/plan-spec/SKILL.md
- 下一步：
skills/execute-implement/SKILL.md
- 方法论出处：唯一真源
docs/AI 编程方法论 v1.2 — 可操作版.md 第 1.2 / 1.3 / 1.4 节
