Retro 是一个面向智能体会话的复盘技能，目标是在会话上下文消失前，把本次会话中暴露的问题转化为对智能体配置的实际修复，并完成检查。它强调输出“已做并已验证的修复”，而不是一份经验教训清单。
用途 在会话结束时回顾本次会话实际发生的事情，找出拖慢进度或出错之处及其原因，然后决定应在何处做何改动，避免下次再发生。
主要能力
- 事实清单：仅基于本次会话，逐项列出发生了什么，并附上发生时刻。包括：所有者纠正智能体（引用原话）；智能体遗漏了已有规则；工作重复或返工；假设被证明错误；工具、脚本或命令失败或需要绕过；所有者等待了智能体本可完成的事。不记录顺利的部分，也不记录仅对未来猜测的内容。
- 归因：将每项归为缺失（没有告诉智能体）、存在但未遵守（规则在但关键时刻未应用，修复路由或代码）、工具缺口（缺少脚本/检查/包装器，修复工具）、技能建议有误（修复项目自身的智能体指令，点名该技能及替代做法）、一次性问题（不会复发，不做修改）。
- 修复，代码优先：优先使用脚本、钩子、校验、必需参数、测试；其次是改进已有指令或路由（改写被误读的规则，或移到规则生效时智能体能看到的位置，先替换或收紧再新增）；只有在会话提供了凭据（日期与发生的事）时才新增规则。规则落地位置：入口文件（如 AGENTS.md）放每次会话都需要的内容；其余放在规则必须改变决策时智能体所读的文件（触发点而非主题归属处），并在入口文件索引中加一行说明何时读取；索引应要求智能体在每个涉及该领域的任务开始时重读该领域文件，而非每会话一次。每个文件保持在字数预算内，规则附带凭据和复查日期。
- 可逆修复在仓库中进行并验证：在必须触发的样本和不触发的样本上运行钩子；打开智能体将读取的路由；运行脚本。未检查的修复报告为未检查。仓库外的更改（用户自己的设置或全局指令）应连同确切文本提出建议，而非直接修改，除非所有者同意。
- 技能引起的摩擦：修复放在项目自身的智能体指令中（技能运行时的路由行，或任意任务都可能触发时的入口文件）；因为插件安装副本在仓库外，复制进仓库的技能会被下次更新覆盖，直接编辑两者都会丢失。然后为技能的源仓库起草变更：技能当前说法、发生了什么（凭据）、替换文本，供所有者在该仓库提 issue；按该仓库技能写法书写，以类别指称产品，不包含会话中的名称、ID、主机名、路径、账号名或值（因为仓库通常是公开的）。
- 报告：每项一行，写明发生了什么、原因、修复及如何验证。若没有值得变更之处，“无需更改配置”是有效结果，优于永不触发的规则。不要设置所有者不愿点击的关卡：过于频繁的守卫会训练出反射性“是”。
使用方式 在已安装插件的 Claude Code 中调用 /agent-harness:retro，可附带描述，如 /agent-harness:retro it ran the tests against the wrong server twice；在 Codex 中调用 $agent-harness:retro；技能文件夹被复制进仓库时，可用 /retro 或 $retro。
适用场景 会话结束前的复盘；需要把反复出现的摩擦固化为钩子、脚本或指令改进；需要验证修复确实生效；需要为上游技能仓库起草问题报告。
限制 仅依据本次会话的事实，不记录猜测；仓库外更改默认只建议不执行；对技能源的修改只能起草供所有者提交；复制进仓库的技能会被更新覆盖；每项修复都需验证，未验证需明确报告；没有可验证证据时不应新增规则。