retro 是一个回顾工具，用于改进智能体（agent）的环境——即下一次会话所依赖的文件、检查和工具。它以一次会话作为证据，关注会话中遇到的摩擦和交付的过度构建，而非产出的代码本身。
用途： 通过分析一次编码会话或工作流运行，找出智能体浪费时间或构建超出需求的地方，并提出少量（最多三个，通常更少）环境修复建议。目标是减少后续会话的浪费，而不是增加规则负担。
主要能力：
- 加载写作指南（agent-docs 和 plain 技能），确保候选的评判和措辞符合规范。
- 读取主要来源：工作流运行文件（plan.md、review.md、learnings.md、wrap.md、WORKLOG.md 等）、会话记录（transcript）、当前生效的指导文件（AGENTS.md、CLAUDE.md、MEMORY.md 索引、全局文件等）以及 SKILL-IMPACT.md 中的试验行。
- 定位每个摩擦点，并附上证据指针（如对话轮次、文件:行号、sha）和成本（分钟、令牌或审查周期）。
- 将摩擦点转化为候选，并合并相同根因的摩擦点。
- 应用五条标准筛选候选：成本高（有数字证据）、重复出现（根因至少出现两次或每次运行都有的步骤）、决策改变（明确哪个智能体在哪个步骤做什么不同）、未覆盖（先阅读目标文件和 SKILL-IMPACT.md，避免重复已有规则）、最小形式（删除或改写优于新增，检查优于文字，现有规则子句优于新规则）。
- 按成本×重复性保留前三项，零结果也是有效的（报告“没有值得做的修复”）。
- 以特定格式呈现保留的修复建议（问题描述、类别、成本、出现次数、证据、选项 a/b、试验证据、已放弃项、内务事项），并等待用户回答。
- 将批准的修复路由到相应的所有者（memory.remember、workflow、checkup 或人类），并记录落地位置。
使用方式： 调用方式有三种：retro（当前会话）、retro <slug>（工作流运行，位于 .workflow/<slug>/）、retro <session id>（指定会话）。工具会按照步骤执行：加载指南、读取主要来源、将摩擦转化为候选、应用标准筛选、保留前三项、呈现建议、路由批准项。
适用场景：
- 编码会话结束后，希望改进智能体环境以减少未来摩擦。
- 工作流运行结束后，分析该次运行的效率问题。
- 识别过度构建、导航困难、缺少护栏、审查规则问题、指导文件冗余、工具使用不当、信息访问障碍、技能自身摩擦等。
限制：
- 最多返回三个修复，通常更少；零结果也是可能的。
- 需要人类批准整体列表，不应逐项权衡。
- 修复必须符合五条标准，否则被放弃。
- 全局指导文件编辑需由人类确认并展示精确差异。
- 工作区卫生问题建议使用 checkup 工具。
- 资料中未提供收费、价格、平台支持等具体信息。