task-planner

Task Planner

你是任务拆解与验证编排技能，目标是输出两份文档：

• .anws/v{N}/05A_TASKS.md（执行主清单）
• .anws/v{N}/05B_VERIFICATION_PLAN.md（验证计划）

---

快速流程

1. 读取 01_PRD.md、02_ARCHITECTURE_OVERVIEW.md
2. 读取 03_ADR/ 与 04_SYSTEM_DESIGN/（如存在）
3. 若 ADR 中存在测试策略/质量门禁，必须优先遵循，不得自行改重
4. 提取公共契约（HTTP API / CLI / 配置 / 错误语义 / 数据结构等）
5. 生成 WBS 任务（System → Phase → Task）到 05A
6. 为每个任务生成验证锚点与证据要求到 05B

---

分轨职责

05A_TASKS.md（执行主清单）

• WBS 任务列表与依赖
• Sprint 路线图
• INT 里程碑任务
• 进度 checkbox
• User Story Overlay

05B_VERIFICATION_PLAN.md（验证计划）

• 验证分层策略
• 风险类别覆盖规则
• Task-by-Task 验证计划
• Contract Coverage Overlay
• Testing Coverage Overlay
• Verification Traceability Matrix

[!IMPORTANT] 上述三项为 05B 的硬性必选章节，不可删除：

• Contract Coverage Overlay
• Testing Coverage Overlay
• Verification Traceability Matrix

---

任务格式（05A）

- [ ] **T{System}.{Phase}.{Seq}** [REQ-XXX]: 任务标题
  - **描述**: 做什么（不是怎么做）
  - **输入**: 设计文档引用 + 前置任务产出（必须包含至少一个文档引用）
  - **输出**: 产出的文件/组件/接口
  - **契约承接**: 本任务实现或验证的公共契约；如无则写"无"
  - **参考**: ADR-XXX 或 System Design 章节（如有）
  - **验收标准**:
    - Given [前置条件]
    - When [执行动作]
    - Then [预期结果]
    - （仅纯技术性基础任务允许使用清晰 Done When 列表）
  - **验证类型**: 单元测试 | API接口功能测试 | 集成测试 | E2E测试 | 冒烟测试 | 回归测试 | 手动验证 | 编译检查 | Lint检查
  - **验证摘要**: 验证目标与边界（不展开完整用例）
  - **验证引用**: `05B_VERIFICATION_PLAN.md#t-x-y-z`
  - **证据产出**: `tests/...`, `reports/...`, `screenshots/...`, `logs/...`
  - **估时**: Xh
  - **依赖**: T{A}.{B}.{C}
  - **优先级**: P0 | P1 | P2

---

验证格式（05B）

Task-by-Task 条目

### T{X}.{Y}.{Z}
- 关联需求:
- 关联契约:
- 风险类别:
- 单元测试覆盖:
- API接口功能测试覆盖:
- 集成/E2E/冒烟覆盖:
- 前置数据:
- 断言:
- 证据:

追溯矩阵

## Verification Traceability Matrix
| REQ/Contract | Task | Verification | Test Material | Evidence | Status |
|---|---|---|---|---|---|

---

验证类型选择逻辑

按"最轻但足够"原则：

1. 局部逻辑 / 纯算法 / 状态转换 / 异常处理 → 单元测试
2. HTTP API / CLI API / 权限边界 / 错误语义 / 数据变更接口 → API接口功能测试
3. 跨模块 / 数据库 / 多服务协作 → 集成测试
4. 直接面向终端用户的关键路径 → E2E测试 或 手动验证
5. Sprint 退出关口 / 里程碑 gate → 冒烟测试（优先绑定 INT-S{N}）
6. 修改可能影响已完成关键能力 → 回归测试
7. 配置/脚手架/基础设施 → 编译检查 / Lint检查 / 手动验证