Retro 是一个编码会话复盘工具，用途是在一次编码会话结束后，分析智能体在哪些环节遇到困难，并据此提出对智能体运行环境（检查、指针、steering、工具等）的改进候选，使下一次运行更顺畅。其定位明确：只提出候选，不直接改动任何内容，需由用户挑选后才实施；它修复的是环境，而非会话产出的代码（后者属于代码审查）。
主要能力围绕一套流程展开。每一步都要求建立任务并设定完成标准。首先获取会话记录：未指定会话时使用当前对话；指定了会话或当前对话过长难以可靠回忆时，运行 python3 scripts/session_digest.py <id-or-path>（可用 --list N --project <repo> 查找），并对摘要中列出的、发生困难时的子智能体记录分别做摘要。其次标记困难时刻：错误、重试、hook 拦截、长时间搜索、超大结果、上下文压缩、用户纠正、走错方向等，并以摘要调用编号（如 #12）或引用用户原话的方式标注。随后读取仓库已有检查（Makefile、package.json 脚本、pre-commit 配置、CI 工作流、.claude/settings.json hooks），已存在但未接入或已损坏的检查本身就作为发现项，替代新增检查。之后把每个困难时刻映射到候选类别，无法追溯到困难时刻的候选项应丢弃。最后按严重程度排序呈现候选，严重程度为困难代价乘以复发频率；每个候选需说明困难时刻、修复方式以及落地的文件。
候选类别覆盖多个方面：导航（智能体找文件或事实耗时过长，修复为从其已读文件中添加指针）；自动化检查（本可由工具捕获的错误，修复为 lint 规则、类型检查、测试、pre-commit hook、CI 任务或 Claude Code 的 PreToolUse/PostToolUse hook；完全没有防护栏的仓库本身就是发现项）；编码标准（审查者漏掉的错误，机械性问题用确定性检查，需判断的问题写入仓库标准文档，且新标准文档需在项目 CLAUDE.md 中加一行指针）；steering 膨胀（全局或项目 CLAUDE.md、AGENTS.md、.claude/rules/、自动记忆 MEMORY.md、SessionStart hook 上下文或技能描述过大，修复为移入检查或标准、按路径限定、收紧描述或改为用户调用）；无效项（智能体默认已遵守或被忽略的 steering 行，删除或替换为检查）；技能（未触发、误触发或误导智能体，修复其描述或正文）；工具经济性（调用代价高或重复调用，修复为更廉价的命令、脚本或更窄的工具）；信息获取（缺少所需信息，修复为将开发服务器日志写入文件、只读访问服务或文档指针）；沙箱与权限（沙箱或 hook 拦截导致重试，修复为应使用的命令模式或由用户调整沙箱/权限规则）。
在放置位置上，工具强调实施者上下文压力最大（需探索、写代码、调试），审查者只拿到 diff，因此规则应放在有空间应用的地方；steering 文件加载到每个会话，应保留给导航指针和适用于所有任务的规则；反复出现的错误应先变成失败的检查再变成文字；判断类规则放入审查者的标准文档而非 CLAUDE.md，优先扩展现有文档；用户偏好纠正放入自动记忆，仓库事实放入仓库。应用选中的候选前需加载对应技能：CLAUDE.md 或 .claude/rules/ 对应 authoring-claude-md，技能对应 skill-creator-primer，hooks、权限或设置对应 update-config；提议的检查在允许其阻断之前应先对仓库运行验证。
适用场景为编码智能体会话的复盘与环境改进，尤其是需要系统性减少重复性错误、优化上下文与工具使用的团队。限制在于：该工具不修改代码、不自动实施改动，依赖会话记录与仓库现有配置的读取，部分步骤要求运行指定脚本，具体效果与平台支持情况资料未提供。