关于 retro
retro 是用于复盘项目 harness 中已完成或升级处理任务的技能。它审查检查点和证据,并记录经验与后续行动,以改进之后的运行。
主要功能
- 01收集运行规范与证据
- 02核对必需检查点及结果
- 03检查证据质量与可追溯性
- 04编写结构化复盘报告
- 05将行动项写入待办与状态记录
适用场景
- 01复盘已交付的运行
- 02记录任务升级处理的原因
- 03结束一个 ultragoal 阶段
- 04将审查结果转为 harness 工作项
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ huytieu/ cog-second-brain --skill retro安装后在 Claude Code 中输入/retro确认已加载。
附带文件references/retro-template.md
详细介绍
/retro — CP-7 完成 V
每次已交付或已升级的非 tiny 运行都要进行复盘。复盘仅供参考,但强烈建议执行:这是改进 harness 的方式。
何时运行
- CP-6 交付后(已批准发布、PR 已合并、vault 交付物已完成)
- 升级后(记录验证器失败的原因)
/ultragoal阶段结束时(每个阶段进行一次复盘)- 手动运行:
/retro <run-dir or spec path>
第 1 阶段 — 收集证据包
阅读:
- 规格说明或卡片描述 + 验收标准
04-projects/harness/runs/<id>/evidence/(台账、checkpoints.tsv、CP-* 文件).claude/logs/loop-ledger.tsv(此运行的最后几行)- 如果是 ultragoal 阶段,则阅读
04-projects/<goal>/STATUS.md
第 2 阶段 — 检查点审计
对于此通道要求的每个 CP,标注预期与实际情况及差距:
| CP | tiny | normal | full |
|---|---|---|---|
| CP-1 spec | 跳过 | 必需 | 必需 |
| CP-3v component | 跳过 | 必需 | 必需 |
| CP-4 integration | 跳过 | 跳过 | 多任务时必需 |
| CP-5 acceptance | 发生变更时 | 必需 | 必需 |
| CP-6 ship | 涉及外部时 | 涉及外部时 | 必需 |
第 3 阶段 — 检查证据质量
请检查:
- 是否有任何已交付的 AC-n 没有 PASS 证据行?(可追溯性违规)
- 是否有任何 PASS 行的观测结果来自工具返回,而非产物?(自信但未经检查)
- 是否有任何标准无法证伪?(在下一份规格说明中修正)
第 4 阶段 — 撰写复盘
将 references/retro-template.md 复制到:
04-projects/harness/retro/YYYY-MM-DD-<slug>.md
填写所有章节。为行动项分配 ID(AI-01…)。
第 5 阶段 — 反馈改进
- 收集:将行动项 + 经验教训追加到今天的收集暂存区
- 待办列表:如果是 harness 工作,将
AI-n行添加到04-projects/harness/BACKLOG.md - STATUS.md:如果是 ultragoal 阶段,则推进阶段状态 + 记录未解决的
AC-n - 规格检查点日志:更新规格说明中的
## Checkpoint logCP-7 行 - 记录:
bash .claude/lib/checkpoint.sh record <run-dir> CP-7 PASS "retro: <path>"
向用户输出
概要:结果、最重要的经验教训、最重要的行动项、复盘路径。
评论
支持 Markdown