Retro - 编码会话复盘与环境优化技能

技能概述

Retro 是一个编码会话复盘技能：它读取你指定的那次会话日志，找出智能体在本次运行中卡壳、绕路、犯错的环节，并把结论转化为对编码环境的具体改进建议——通常是 CLAUDE.md / AGENTS.md 里的一条导航指针、CODING_STANDARDS.md 里的一条规则，或者一处该加的自动化检查。

适用场景

1. 一次会话耗时过长，想搞清楚时间花在哪了 智能体反复翻找文件、迟迟定位不到正确入口，往往说明缺少一条导航指针。Retro 会把这类"找信息"的耗时点单独拎出来。
2. 同一个错误反复出现 那些本该被 lint、类型检查或测试拦住的错误，或者本该由审查环节拦住、却没人告诉审查者的规则，都可以在复盘后固化成自动化检查或编码规范。
3. 项目配置和文档越堆越大 当 AGENTS.md 膨胀到没人读得完、里面还混着不影响行为的"无效指令"时，Retro 会指出哪些内容该下沉到编码规范、哪些该改成检查脚本，以及哪些信息智能体本来就拿不到、需要额外打通。

核心功能

1. 读取一手会话记录 按用户指定的会话（未指定则默认当前会话）翻查日志，基于真实发生的过程而不是印象来复盘。
2. 按七个方向定位改进点 导航（是否该加导航指针）、自动化检查（哪些错误本可被机器拦住）、编码规范（审查规则该增该删该澄清）、全局 AGENTS.md（哪些指令该挪走）、工具经济性（是否有昂贵的工具调用可以精简）、无效指令（哪些指令实际不改变智能体行为）、信息获取（是否缺少关键信息来源，比如开发服务器日志、第三方服务的只读访问）。每个方向都对应一个明确的触发条件，而不是泛泛而谈。
3. 按严重程度排序给出改进候选 复盘输出是一份排好序的候选清单，交由用户决定采纳哪些，技能本身不直接改动项目。

常见问题

retro 会修改我的代码或配置文件吗？

不会。Retro 的产出是改进建议清单，按严重程度排序呈现给用户，由用户决定采纳哪些、如何落地。它不会自动改写代码、CLAUDE.md 或任何配置。

retro 和代码审查（code review）有什么区别？

代码审查针对的是一次改动——拿到 diff 就能做，实施者不需要再探索代码，因此审查环节上下文压力最小，也最适合承担"强制推行编码规范"的职责。Retro 针对的是一次会话过程——它关心的是实施者当时为什么找不到文件、为什么踩了坑，进而改进环境本身。两者的改进方向常常互补：审查环节更适合加规则，复盘更适合加导航和检查。

不指定会话时，retro 复盘哪一次？

默认复盘当前会话。如果你想复盘历史会话，需要明确指定——这可能意味着要在本机的会话日志里做检索。