用途:retro 是 CP-7 复盘环节,用于在非微小任务交付或升级后回顾整个 V 模型流程,审计检查点、证据质量、行动项与可收割经验,并反馈到下一轮运行。它是建议性但被强烈期望执行的步骤。
触发时机:CP-6 交付后(发布获批、PR 合并、vault 交付完成)、升级后(记录验证器失败原因)、/ultragoal 阶段结束时(每阶段一次),或手动执行 /retro <run-dir 或 spec 路径>。
主要流程:
- 收集证据包:读取 spec 或卡片描述与验收标准、04-projects/harness/runs/<id>/evidence/ 下的 ledger、checkpoints.tsv、CP-* 文件、.claude/logs/loop-ledger.tsv 中该运行的最后几行,以及 ultragoal 阶段的 STATUS.md。
- 检查点审计:按 tiny、normal、full 三档对比每个 CP 的 Expected、Actual 与 Gap,涉及 CP-1 spec、CP-3v component、CP-4 integration、CP-5 acceptance、CP-6 ship。
- 证据质量检查:确认是否存在无 PASS 证据行的 AC-n(可追溯性违规)、PASS 行的观察是否为工具返回而非产物(自信但未核实)、以及不可证伪的标准。
- 撰写复盘:将 references/retro-template.md 复制到 04-projects/harness/retro/YYYY-MM-DD-<slug>.md,填写所有章节,行动项编号为 AI-01 等。
- 前馈:将行动项与经验追加到当日 harvest 暂存区;如属 harness 工作则把 AI-n 行加入 04-projects/harness/BACKLOG.md;ultragoal 阶段则推进阶段状态并记录未完成 AC-n;更新 spec 的 ## Checkpoint log CP-7 行;执行 bash .claude/lib/checkpoint.sh record <run-dir> CP-7 PASS "retro: <path>"。
输出:向用户给出 TL;DR,包含结果、首要经验、首要行动项与复盘文件路径。
限制:资料未提供该技能的安装方式、收费、平台支持或效果保证等信息。