mcpField
R
retro

retro

github.com/huytieuAgent 工作流1.3k115 次安装1 周前更新
代码仓库

关于 retro

retro 是用于复盘项目 harness 中已完成或升级处理任务的技能。它审查检查点和证据,并记录经验与后续行动,以改进之后的运行。

主要功能

  1. 01收集运行规范与证据
  2. 02核对必需检查点及结果
  3. 03检查证据质量与可追溯性
  4. 04编写结构化复盘报告
  5. 05将行动项写入待办与状态记录

适用场景

  1. 01复盘已交付的运行
  2. 02记录任务升级处理的原因
  3. 03结束一个 ultragoal 阶段
  4. 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 阶段 — 收集证据包

阅读:

  1. 规格说明或卡片描述 + 验收标准
  2. 04-projects/harness/runs/<id>/evidence/(台账、checkpoints.tsv、CP-* 文件)
  3. .claude/logs/loop-ledger.tsv(此运行的最后几行)
  4. 如果是 ultragoal 阶段,则阅读 04-projects/<goal>/STATUS.md

第 2 阶段 — 检查点审计

对于此通道要求的每个 CP,标注预期与实际情况及差距:

CPtinynormalfull
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 阶段 — 反馈改进

  1. 收集:将行动项 + 经验教训追加到今天的收集暂存区
  2. 待办列表:如果是 harness 工作,将 AI-n 行添加到 04-projects/harness/BACKLOG.md
  3. STATUS.md:如果是 ultragoal 阶段,则推进阶段状态 + 记录未解决的 AC-n
  4. 规格检查点日志:更新规格说明中的 ## Checkpoint log CP-7 行
  5. 记录:bash .claude/lib/checkpoint.sh record <run-dir> CP-7 PASS "retro: <path>"

向用户输出

概要:结果、最重要的经验教训、最重要的行动项、复盘路径。

评论

支持 Markdown