mcpField
R
retro

retro

github.com/lwlee2608Agent 工作流16 次安装1 天前更新
代码仓库

关于 retro

用于复盘会话记录的技能,会整理各阶段耗时、用户等待、错误和重复检查,并指出可改进的流程。它依据当前会话 ID 定位记录,只报告分析结果,不修改文件。

主要功能

  1. 01按会话 ID 定位记录
  2. 02提取提示词与工具调用时间线
  3. 03统计各阶段耗时
  4. 04归类工具调用错误
  5. 05识别重复检查与低效操作
  6. 06只报告结果,不编辑文件

适用场景

  1. 01复盘 Agent 会话的时间分配
  2. 02查找反复失败的工具调用原因
  3. 03发现重复测试或重复检索
  4. 04为后续会话改进流程

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/lwlee2608/agent-skills --skill retro

安装后在 Claude Code 中输入/retro确认已加载。

详细介绍

回顾

审查一次会话记录。报告执行情况、时间花在了哪里,以及下次应做哪些调整。

规则

  1. 默认审查当前会话。 通过当前会话的 ID 查找,绝不要按最新文件查找;并行会话会共用一个项目文件夹。也可以接受会话 ID 或记录文件路径。包含子 Agent 的会话记录,因为它们的工作也应计入。OpenCode 将会话保存在数据库中,因此要说明不支持。

  2. 阅读前先精简会话记录。 会话记录可能有数 MB,大部分是工具输出。提取简短时间线:每条用户提示,以及每次工具调用的时间、耗时、输入和错误。只有在某个错误需要时才查看完整结果。

  3. 为每个阶段计时。 阶段包括理解、实现、测试、审查和其他(git、CI、部署)。阶段持续到下一个阶段开始。等待用户的时间不算 Agent 时间;应单独报告。向用户提问和权限提示都算作等待用户。后台任务的完成时间晚于调用显示的时间,因此应以其完成通知为准。忽略本次回顾自身的调用。

  4. 标记无故重跑的耗时检查。 耗时检查包括 Playwright、端到端测试、集成测试、完整测试套件或 CI 监控。若未更改任何受其覆盖的代码,或更窄范围的检查已足以验证修复,则重跑属于浪费。相关代码更改后的重跑是合理的。

  5. 按原因归类工具调用错误。 例如:路径错误、参数错误、权限被拒、命令缺失。未作任何更改就重试的失败调用最值得关注。

  6. 找出浪费精力的地方。 留意以下情况:

    • 忽略了技能步骤,或技能步骤本身导致浪费
    • 重复查找同一内容
    • 搜索即可解决,却读取了整个文件
    • 独立调用逐个运行
    • 用子 Agent 处理琐碎任务
    • 用户纠正(“不对”“我说过”“再来一次”)

    将每项问题与需要调整的技能、指令文件或习惯对应起来。

  7. 只报告,不要编辑。 由用户决定要改什么。

  8. 按 Agent 时间中浪费时间的占比评分。 A:无浪费。B:低于 10%。C:10–25%。D:25–50%。F:超过 50%,或任务失败。

  9. 按此格式回复。 每项发现都要注明时间戳。省略空白章节。如果会话执行顺利,用一行说明即可;绝不编造发现。

    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>
    

评论

支持 Markdown