用途
retro 用于对一次编码会话进行回顾,目标是向编码智能体的环境提出改进建议,以改善未来的运行效果。用户请求进行回顾时,该技能会分析指定会话的日志,寻找可优化的地方。
主要能力
该技能会从以下类别中寻找改进候选,并按严重程度呈现给用户:
- 导航:评估智能体查找正确文件的难易程度,是否存在隐藏依赖,是否需要导航指针。适用于会话中查找信息耗时较长的情况。
- 自动化检查:判断是否有自动化检查能捕获智能体犯的错误,例如 lint、类型检查、测试、文件系统检查器。会先读取仓库自身的检查命令(如 package.json 中的脚本、CI 工作流),避免重复造轮子。没有防护栏(无 pre-commit 钩子且无 CI 运行 lint/类型检查/测试命令)的仓库本身就是一个发现。适用于智能体犯了可被自动化检查捕获的错误,或仓库完全没有防护栏的情况。
- 编码标准:判断是否应给审查智能体新增规则,或删除/澄清现有规则。违规分为机械性(固定语法模式、禁用 API、导入形状、文件位置规则)和需要判断的情况。机械性违规应构建确定性检查(如仓库自身 linter 的自定义规则、新的 pre-commit 钩子或 CI 任务),默认构建检查而非编写规则。CODING_STANDARDS.md 仅用于真正的判断性情况。适用于审查智能体未能捕获错误的情况。
- 全局 AGENTS.md:判断是否有引导指令应移到编码标准或自动化检查中。适用于 AGENTS.md 文件特别大(仓库或用户全局作用域)的情况。
- 工具经济性:检查智能体是否有可简化的昂贵工具调用,或自定义工具(CLI、MCP)是否 token 效率低下。适用于智能体进行了昂贵工具调用的情况。
- 无效指令:查找引导文件中不改变智能体行为的指令。适用于引导文件庞大且笨重的情况。
- 信息访问:寻找增加智能体信息访问的机会,如 tee 开发服务器日志、只读访问第三方服务。适用于智能体无法获取关键信息的情况。
使用方式
用户请求回顾。技能会先调用 Skill 工具获取 writing-for-agents 的写作风格指南。然后读取用户指定会话的主要来源,可能需要在机器上搜索会话日志;如果用户未指定会话,默认使用当前会话。分析后,将改进候选项按严重程度呈现给用户。
适用场景
适用于希望从编码会话中总结经验、改进智能体工作环境的开发者,特别是当会话中出现查找信息困难、可被自动化检查捕获的错误、审查遗漏、引导文件过大、工具调用昂贵或关键信息缺失等情况时。
限制
该技能依赖会话日志和仓库中的配置文件(如 CLAUDE.md/AGENTS.md、CODING_STANDARDS.md、docs、skills 等)。其建议基于对日志和文件的分析,不保证所有改进都适用。具体实现细节和效果暂未提供。