Plan From Spec

• 规格文档：context/spec/ 下所有 .md 文件（README.md 除外）
• 项目约束：context/constitution.md
• 架构说明：context/architecture.md（如存在）
• 模块划分：context/modules/index.yaml（如存在）
• 合约模板：templates/task-contract.yaml
• 状态模板：templates/task-state.yaml

等待 spec-planner 完成 Phase 1-5，输出到 tasks/ 目录。

Step 3：调用 contract-reviewer 审查

对 spec-planner 生成的每个 Task Contract 调用 @contract-reviewer：

遍历 tasks/S*.yaml：
  对每个文件调用 @contract-reviewer
  收集审查意见（YAML 格式：decision + issues + summary）
  如果有 critical 级别问题 → 标记该 Contract 需要修改

将审查结果汇总输出到 tasks/REVIEW-REPORT.md：

# Contract 审查报告

生成时间：{ISO timestamp}
审查范围：tasks/S*.yaml

## 通过（无问题）
- S01: 标题 ✅
- S02: 标题 ✅

## 有 warning（可接受）
- S05: 标题
  - [warning] 具体问题描述

## 需要修改（有 critical）
- S07: 标题
  - [critical] 具体问题描述
  - [warning] 具体问题描述

## 规格覆盖检查
- 未覆盖章节：{列出或 "无 ✅"}
- 重复覆盖章节：{列出或 "无"}

Step 4：自动修正

对审查中有 critical 问题的 Contract，调用 @spec-planner 进入修正模式：

对每个有 critical 的 Contract：
  将审查意见传给 @spec-planner
  @spec-planner 修正 Contract YAML
  再次调用 @contract-reviewer 验证
  最多 2 轮修正
  2 轮后仍有 critical → 标记 needs-human: true，记入 REVIEW-REPORT.md

Step 5：输出汇总

生成最终的计划汇总，输出到终端 + tasks/PLAN-SUMMARY.md：

# 规划汇总

## Gate 概览

### Gate-1: {用户故事}
  S01 ~ S{NN}（{N} 个 task）

### Gate-2: {用户故事}
  S{NN} ~ S{NN}（{N} 个 task）

...

## 统计

- 总计：{N} 个 task，{M} 个 Gate
- 审查结果：✅ 通过 {X} 个 / ⚠️ warning {Y} 个 / ❌ 需人工确认 {Z} 个

## 产出文件

- `tasks/GATE-PLAN.md` — Gate 规划文档
- `tasks/PLAN-COVERAGE.md` — 规格覆盖矩阵
- `tasks/PLAN-SELF-CHECK.md` — 自检报告
- `tasks/REVIEW-REPORT.md` — 审查报告
- `tasks/S*.yaml` — Task Contracts
- `tasks/GATE-*.yaml` — Gate 验收 Contracts

## 下一步

1. 查看 tasks/GATE-PLAN.md 了解整体规划
2. 查看 tasks/REVIEW-REPORT.md 了解审查详情
3. 确认后运行 `make approve-plan` 批准全部 task
4. 或逐个批准：`make approve TASK=S01`
5. 运行 `make start` 开始执行

Step 6：等待人确认

不自动开始执行。 人工检查产出文件后：

# 批准全部 task（将 approval_status 从 draft 改为 approved）
make approve-plan

# 或逐个批准
make approve TASK=S01

# 开始执行
make start

失败处理