Iteration 编写指南（测试执行 → 分析 → 自主修复）
目标与定位
- 本指南用于单轮迭代：首次运行测试 → 分析问题 → Codex 自主修复 → 再测试与收敛。
- 以减少人工介入为目标，围绕 Draft/Plan/Code 的既有产出快速闭环，进入可验收状态。
- Plan 文档：技术验收清单与执行顺序（权威验收边界）。
- Code 文档：已实现内容与测试用例（未运行）记录。
- Draft 文档：业务语义参考；如与 Plan 冲突，以 Plan 为准。
- 初次运行测试
- 执行全量测试并收集统计（总数/通过/失败/跳过/耗时）。
- 记录失败明细：用例标识、报错摘要、证据（日志/截图路径）。
- 问题分析与归类
- 基于失败用例与日志定位根因，按类型归类（功能/逻辑/契约/性能/环境等）。
- 标注严重级与影响范围；必要时提出测试修订建议（若测试用例本身与 Plan 验收不一致）。
- 自主修复
- 由 Codex 自主修复，保持可读性与一致性；必要时同步契约/类型。
- 按需运行相关测试验证修复效果；避免不必要的联动变更。
- 再测试与收敛
- 重新运行全量测试；对比首次结果，确认失败项清零或明确剩余阻塞。
- 运行质量检测（pnpm：typecheck/lint/format:check），记录结果。
- 输出结论与落档
- 汇总“已解决/未解决/推迟”的问题清单与原因；对 Plan 验收清单给出映射结论。
- 产出 Iteration 记录文档（见 Template），作为 Review 的输入。
每步记录要点（配套 Template）
- 初次测试结果：统计、失败清单、证据。
- 问题分析与分类：根因、类型、严重级、影响范围、与 Plan 验收的关系。
- 修复实施：修改摘要、涉及文件、对应用例标识、契约/类型同步（如有）。
- 再测试结果：统计对比、剩余问题与原因。
- 质量检测（pnpm）：typecheck/lint/format:check 摘要。
- 验收结论：对 Plan 验收清单的覆盖与结论；遗留项与后续建议。
完成定义（DoD）
- 全量测试通过；或仅剩“已标注原因且可推迟”的非阻塞项。
- 质量检测（pnpm）通过（类型/风格/格式）。
- 契约/类型变化已同步并记录影响范围；必要的 Plan 回写事项已产生。
- Iteration 文档完整，可直接用于 Review。
输出与落档
- 迭代结束后输出 Iteration 文档（按 Template），并给出“执行结果汇总简报”。
- 若仍有阻塞项，给出最小行动建议与下一步（继续 Iteration 或进入 Review 的前置清单）。