retro

技能简介

retro 技能用于对一次编码会话进行回顾，通过分析会话日志和辅助文件，找出编码代理（agent）运行环境中可改进的地方，从而提升未来会话的效率与质量。

使用场景

• 一次编码会话耗时过长，难以快速定位关键信息
• 代理犯了本可通过自动化检查提前发现的错误
• 审查代理（reviewer agent）未能拦截某些编码规范问题
• AGENTS.md 或全局指导文件变得庞大、难以维护
• 代理执行了成本较高的工具调用，希望简化流程

使用方法

当用户要求对编码会话进行回顾时，可触发该技能。默认回顾当前会话；用户也可以指定其他会话，技能会搜索本机上的会话日志。具体流程：

1. 调用 writing-for-agents 技能获取写作风格指南。
2. 读取用户指定的会话主数据；若未指定，默认使用当前会话。
3. 从以下类别中寻找可改进项，并按严重程度排序后呈现给用户：
   • 导航：代理查找文件是否困难？是否存在隐藏依赖？
   • 自动化检查：能否通过 lint、类型检查、测试或文件系统检查捕获代理的错误？
   • 编码标准：是否应给审查代理添加新规则，或修改现有规则？
   • 全局 AGENTS.md：是否应将指导指令移入编码标准或自动化检查？
   • 工具经济性：是否存在高成本的工具调用可被简化？
   • 无效指令：指导文件中是否有不影响代理行为的冗余内容？
   • 信息访问：是否有机会增加代理的信息获取途径（如开发服务器日志、第三方服务只读权限）？

注意事项

• 该技能由用户显式要求触发，代理不会自行调用。
• 回顾过程涉及会话日志读取，请确保用户已授权访问相关文件。
• 实现与审查阶段应分离：编码标准应由审查代理负责执行，而非实现代理。