Retro：为 AI Agent 做复盘
前言：复盘 AI Agent 的工作
AI Agent 写完代码，就结束了吗？
不。
还需要复盘。
Retro 是一个 Skill，用来为 AI Agent 做复盘。
一、核心流程
五步流程：
- 获取写作风格指南
- 读取会话日志
- 识别改进机会
- 按严重程度排序
- 呈现给用户
二、八个改进方向
1. 导航（Navigation）
问题：Agent 找到正确的文件有多容易？文件之间是否有隐藏的依赖关系？导航指针能让它更容易吗？
使用场景：当会话花费很长时间才找到一条信息时。
改进建议：
- 添加导航指针
- 建立文件依赖图
- 优化文件结构
2. 自动化检查（Automated Checks）
问题：是否有自动化检查可以捕获 Agent 犯的错误？Linting、typing、tests、filesystem linters？
使用场景：当 Agent 犯了一个可以通过自动化检查捕获的错误时。
改进建议：
- 添加 Linting 规则
- 添加类型检查
- 添加测试
- 添加文件系统检查
3. 编码标准（Coding Standards）
问题：是否应该给审查代理一个新规则来执行？是否应该删除或澄清现有规则？
使用场景：当审查代理未能捕获一个错误时。
改进建议：
- 添加新的编码标准
- 删除过时的标准
- 澄清模糊的标准
4. 全局 AGENTS.md（Global AGENTS.md）
问题：是否有任何指导指令应该移到编码标准（或自动化检查）而不是 AGENTS.md？
使用场景：当 AGENTS.md 文件特别大时 - 在仓库或用户的全局范围内。
改进建议：
- 将通用指令移到编码标准
- 将可自动化检查移到自动化检查
- 保持 AGENTS.md 简洁
5. 工具经济（Tool Economy）
问题：Agent 是否进行了昂贵的工具调用，可以简化？是否有任何自定义工具（CLI、MCP）特别 token-低效？
使用场景：当 Agent 进行了昂贵的工具调用时。
改进建议：
- 优化工具调用
- 减少 token 消耗
- 改进工具设计
6. 空操作（No-ops）
问题：寻找指导文件中不修改 Agent 行为的指令。
使用场景：当指导文件庞大且笨重时。
改进建议：
- 删除无效指令
- 简化指导文件
- 提高指导效率
7. 信息访问（Information Access）
问题：寻找增加 Agent 对信息访问的机会。Teeing dev server 日志、对第三方服务的只读访问。
使用场景：当一个关键信息对 Agent 不可用时。
改进建议：
- 提供日志访问
- 提供第三方服务只读访问
- 增加信息透明度
8. 实现 vs 审查（Implementation vs Review）
核心原则：所有工作都经过两个阶段：实现和审查。
实现代理：上下文压力最大。负责探索、编写代码和调试失败。
审查代理：上下文压力最小 - 接收 diff，不需要探索。通常不需要编写代码或调试。
含义：审查代理应该负责执行编码标准，而不是实现代理。
三、文件组织
CLAUDE.md/AGENTS.md
这些文件被推送到在此仓库中工作的任何代理的上下文窗口。应该非常谨慎地使用，通常只用于导航指针到其他文件。
CODING_STANDARDS.md
这个文件在审查期间读取，而不是实现。如果标准文件超过 1,000 行，添加导航指针到 docs 文件夹。
Docs
使用 docs 作为参考文件，由其他文件指向。在编写新文档之前寻找现有文档。
Skills
使用技能进行文档（因为它们的描述进入代理的上下文窗口），或用于用户调用的命令。
四、使用方法
安装
Retro 是一个 Skill。
GitHub：https://github.com/mattpocock/skills
使用
在支持 Skills 的环境中使用 Retro：
#retro
Conduct a retrospective on a coding session.输入：会话日志或当前会话
输出：改进建议，按严重程度排序
五、核心原则
实现 vs 审查
实现代理：
- 上下文压力最大
- 负责探索、编写代码、调试失败
审查代理：
- 上下文压力最小
- 接收 diff，不需要探索
- 通常不需要编写代码或调试
含义：审查代理应该负责执行编码标准，而不是实现代理。
文件使用
CLAUDE.md/AGENTS.md：
- 被推送到上下文窗口
- 应该非常谨慎地使用
- 通常只用于导航指针
CODING_STANDARDS.md：
- 在审查期间读取
- 超过 1,000 行，添加导航指针
Docs：
- 作为参考文件
- 由其他文件指向
- 在编写新文档之前寻找现有文档
Skills：
- 用于文档
- 用于用户调用的命令
- 描述进入上下文窗口
六、总结
五步流程
- 获取写作风格指南
- 读取会话日志
- 识别改进机会
- 按严重程度排序
- 呈现给用户
八个改进方向
导航：文件查找、依赖关系、导航指针
自动化检查：Linting、typing、tests、filesystem linters
编码标准：新规则、删除规则、澄清规则
全局 AGENTS.md：移到编码标准或自动化检查
工具经济：简化工具调用、减少 token 消耗
空操作：删除无效指令、简化指导文件
信息访问：日志访问、第三方服务只读访问
实现 vs 审查：审查代理负责执行编码标准
文件组织
CLAUDE.md/AGENTS.md：上下文窗口，导航指针
CODING_STANDARDS.md：审查时读取，编码标准
Docs：参考文件，导航指针指向
Skills：文档或用户命令，上下文窗口描述
记住
AI Agent 写完代码，就结束了吗？
不。还需要复盘。
Retro 用来为 AI Agent 做复盘。
附：Retro Skill
GitHub：https://github.com/mattpocock/skills 路径：skills/in-progress/retro/SKILL.md 描述：Conduct a retrospective on a coding session.
请前往草稿箱查看： https://mp.weixin.qq.com/
"