chief-retro

对当前里程碑进行复盘。

范围检测

自动检测范围：

1. 读取当前活动里程碑中的 _plan/_todo.md。
2. 如果所有任务都标记为 [x] → 里程碑复盘。
3. 如果仍有未完成的任务 → 批次复盘（仅涵盖最近完成的批次）。

输入来源

批次复盘

• 最新的 _report/autopilot-run-batch-<N>.md
• _plan/_todo.md（已完成与剩余任务）
• _goal/ 和 _contract/ 文件
• 自上一份批次报告（或里程碑开始）以来的 git log

里程碑复盘

• 所有 _report/ 文件（批次报告、任务输出等）
• _plan/_todo.md（完整历史）
• _goal/ 和 _contract/ 文件
• 整个里程碑期间的 git log

报告章节

按以下章节撰写报告：

# Retro: <milestone> — <batch N | milestone>

## Coverage Check

For each goal and contract file, check whether the work done satisfies it:

| File | Status | Notes |
|------|--------|-------|
| _goal/xxx.md | ✅ Satisfied / ⚠️ Partial / ❌ Missing | what's done or missing |
| _contract/xxx.md | ✅ / ⚠️ / ❌ | ... |

## Planned vs Delivered

- What was in the TODO
- What was actually completed
- What was skipped or changed mid-execution

## Blockers Hit

- Issues encountered during execution
- How they were resolved (or not)

## Lessons Learned

- Patterns observed (good and bad)
- Recurring problems
- Surprises or unexpected outcomes
- What worked well and should be repeated

## Proposed Rule Updates

For each proposal:
- **What:** the rule to add or change
- **Where:** which file in `.chief/_rules/` (e.g. `_standard/auth.md`, `_verification/tests.md`)
- **Why:** what happened that motivates this rule
- **Suggestion:** recommended for the user

## User Action Needed

Items requiring human decision:
- Uncovered goals or contracts that need another batch
- Decisions to promote to permanent rules
- Manual steps that automation couldn't handle

输出文件

• 批次复盘 → .chief/<milestone>/_report/retro-batch-<N>.md
• 里程碑复盘 → .chief/<milestone>/_report/retro-milestone.md

其中 <N> 与正在复盘的批次编号一致。

报告完成后

向用户展示拟议的规则更新。询问：

“要我应用其中的哪些规则提案吗？”

• 用户选择要应用的提案。
• 对于每个获批提案，在 .chief/_rules/ 中创建或更新文件。
• 对于被拒绝的提案，仅保留在报告中。

规则

• 绝不跳过覆盖范围检查——这是复盘的核心价值。
• 绝不自动应用规则提案——务必先征求用户同意。
• 绝不修改目标、合同或计划——复盘对这些内容只读。只有 _rules/ 可以更新。
• 使用实际的 git log 和文件内容——不要凭记忆总结。
• 遵循规则层级：AGENTS.md > .chief/_rules > 里程碑目标。