关于 retro
用于复盘会话记录的技能,会整理各阶段耗时、用户等待、错误和重复检查,并指出可改进的流程。它依据当前会话 ID 定位记录,只报告分析结果,不修改文件。
主要功能
- 01按会话 ID 定位记录
- 02提取提示词与工具调用时间线
- 03统计各阶段耗时
- 04归类工具调用错误
- 05识别重复检查与低效操作
- 06只报告结果,不编辑文件
适用场景
- 01复盘 Agent 会话的时间分配
- 02查找反复失败的工具调用原因
- 03发现重复测试或重复检索
- 04为后续会话改进流程
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ lwlee2608/ agent-skills --skill retro安装后在 Claude Code 中输入/retro确认已加载。
详细介绍
回顾
审查一次会话记录。报告执行情况、时间花在了哪里,以及下次应做哪些调整。
规则
-
默认审查当前会话。 通过当前会话的 ID 查找,绝不要按最新文件查找;并行会话会共用一个项目文件夹。也可以接受会话 ID 或记录文件路径。包含子 Agent 的会话记录,因为它们的工作也应计入。OpenCode 将会话保存在数据库中,因此要说明不支持。
-
阅读前先精简会话记录。 会话记录可能有数 MB,大部分是工具输出。提取简短时间线:每条用户提示,以及每次工具调用的时间、耗时、输入和错误。只有在某个错误需要时才查看完整结果。
-
为每个阶段计时。 阶段包括理解、实现、测试、审查和其他(git、CI、部署)。阶段持续到下一个阶段开始。等待用户的时间不算 Agent 时间;应单独报告。向用户提问和权限提示都算作等待用户。后台任务的完成时间晚于调用显示的时间,因此应以其完成通知为准。忽略本次回顾自身的调用。
-
标记无故重跑的耗时检查。 耗时检查包括 Playwright、端到端测试、集成测试、完整测试套件或 CI 监控。若未更改任何受其覆盖的代码,或更窄范围的检查已足以验证修复,则重跑属于浪费。相关代码更改后的重跑是合理的。
-
按原因归类工具调用错误。 例如:路径错误、参数错误、权限被拒、命令缺失。未作任何更改就重试的失败调用最值得关注。
-
找出浪费精力的地方。 留意以下情况:
- 忽略了技能步骤,或技能步骤本身导致浪费
- 重复查找同一内容
- 搜索即可解决,却读取了整个文件
- 独立调用逐个运行
- 用子 Agent 处理琐碎任务
- 用户纠正(“不对”“我说过”“再来一次”)
将每项问题与需要调整的技能、指令文件或习惯对应起来。
-
只报告,不要编辑。 由用户决定要改什么。
-
按 Agent 时间中浪费时间的占比评分。 A:无浪费。B:低于 10%。C:10–25%。D:25–50%。F:超过 50%,或任务失败。
-
按此格式回复。 每项发现都要注明时间戳。省略空白章节。如果会话执行顺利,用一行说明即可;绝不编造发现。
Session: <id> (<harness>), <start>–<end>, <agent time> agent / <user wait> user wait Grade: <A–F> — <one-line reason> Time by phase | Phase | Time | % | Notes | Wasteful verification - <suite> run <N>× (<total>) at <times> — <why wasteful>; saves ~<time> Tool-call errors - <N>× <cause> at <times> — <fix> Improvements 1. <file or skill>: <one-line change> — <evidence>