# Plan Breakdown

> 任务归约拆分与验收标准前置。Use when 已有 Spec 或较清晰的需求、要把大需求切成可执行任务、准备启动开发之前。也适用于需求太大、一个 Agent 无法独立完成、需要拆成 Epic/Milestone/Issue 并定义 P0-P3 验收标准的场景。

- Skill: `swustcyt/plan-breakdown` (Agent Skill)
- Install (CLI): `npx skillmds@latest add swustcyt/plan-breakdown`
- Raw SKILL.md: https://api.skillmd.com/api/skills/swustcyt/plan-breakdown/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: SWUSTcyt (https://skillmd.com/u/swustcyt)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/swustcyt/plan-breakdown

---


# Plan-Breakdown：归约拆分 + 验收标准前置

## 概述

承接 plan-spec 的 Spec，把需求从大到小逐层拆解，直到每个任务单元能被一个 Agent 独立完成；同时在创建时就写清每个 Issue 的 P0-P3 验收标准，并维护项目的 Plan Document。

**核心原则：** 任务足够小 + 标准前置不可回调。拆到位、标准定死，是后续高质量执行的地基。

## 何时使用

- 已有 Spec（来自 plan-spec），要开始拆任务
- 新 Milestone 启动 / 计划需要重新拆分
- 一个需求大到单个 Agent 无法一次做对

**何时不用：** 单个明确的小改动；需求尚未澄清（先用 plan-spec）。

## 流程

1. **拆 Epic** — 每个 Epic = 一个独立功能模块，先拆当前需要的 2-3 个。
2. **拆 Milestone** — 选第一个 Epic，拆出 Milestone，每个含：起始条件、交付物、验收标准。只细化前 1-2 个。用 `templates/milestone-template.md`。
3. **拆 Issue** — 选第一个 Milestone，拆到 Issue 级别。每个 Issue 含：任务描述、输入/输出、依赖条件、P0-P3 验收标准。用 `templates/issue-template.md`。
4. **写验收标准（前置）** — 拆 Issue 的同时按 P0-P3 分级写验收标准（见下表），让用户确认/调整。
5. **维护 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 节