planning-and-task-breakdown

规划与任务拆解

概览

把工作拆成小而可验证的任务，并给每个任务明确的验收标准。好的任务拆解，是 agent 能稳定完成工作与把事情做成一团乱麻之间的区别。每个任务都应该小到可以在一次专注会话中完成实现、测试和验证。

何时使用

• 你已经有 spec，需要把它拆成可执行单元
• 任务太大或太模糊，难以下手
• 工作需要在多个 agent 或多个会话之间并行展开
• 你需要向人类说明工作范围
• 实现顺序并不明显

不适用的场景： 单文件且范围显而易见的改动，或 spec 中已经包含了定义清晰的任务。

规划流程

步骤 1：进入规划模式（Plan Mode）

在写任何代码之前，先以只读模式工作：

• 阅读 spec 和相关代码区域
• 识别现有模式和约定
• 绘制组件间依赖
• 记录风险与未知项

规划阶段不要写代码。 产出应该是一份计划文档，而不是实现。

步骤 2：识别依赖图

先画清楚谁依赖谁：

Database schema
    │
    ├── API models/types
    │       │
    │       ├── API endpoints
    │       │       │
    │       │       └── Frontend API client
    │       │               │
    │       │               └── UI components
    │       │
    │       └── Validation logic
    │
    └── Seed data / migrations

实现顺序应该沿依赖图自底向上推进，先打基础。

步骤 3：做纵向切片

不要先做完整数据库、再做完整 API、再做完整 UI。应该一次打通一条完整功能路径：

坏例子（水平切片）：

Task 1: Build entire database schema
Task 2: Build all API endpoints
Task 3: Build all UI components
Task 4: Connect everything

好例子（纵向切片）：

Task 1: User can create an account (schema + API + UI for registration)
Task 2: User can log in (auth schema + API + UI for login)
Task 3: User can create a task (task schema + API + UI for creation)
Task 4: User can view task list (query + API + UI for list view)

每个纵向切片都能交付可工作的、可测试的功能。

步骤 4：编写任务

每个任务都遵循如下结构：

## Task [N]: [简短描述性标题]

**Description:** 一段话说明这个任务完成什么。

**Acceptance criteria:**
- [ ] [具体且可测试的条件]
- [ ] [具体且可测试的条件]

**Verification:**
- [ ] Tests pass: `npm test -- --grep "feature-name"`
- [ ] Build succeeds: `npm run build`
- [ ] Manual check: [需要检查什么]

**Dependencies:** [依赖哪些任务编号，或写 "None"]

**Files likely touched:**
- `src/path/to/file.ts`
- `tests/path/to/test.ts`

**Estimated scope:** [Small: 1-2 files | Medium: 3-5 files | Large: 5+ files]

步骤 5：排序并设置检查点

排列任务时确保：

1. 依赖先满足，基础优先
2. 每个任务完成后系统仍处于可工作状态
3. 每做完 2 到 3 个任务就设置一次验证检查点
4. 高风险任务尽量提前，尽早失败

加入显式检查点：

## Checkpoint: After Tasks 1-3
- [ ] All tests pass
- [ ] Application builds without errors
- [ ] Core user flow works end-to-end
- [ ] Review with human before proceeding