用途
retro 用于对一次编码会话进行回顾(retrospective)。当用户要求复盘时,该技能会针对编码智能体的环境提出改进建议,以改善未来的运行效果。
主要能力
技能会阅读用户指定会话的原始资料(可能包括本机上的会话日志;若用户未指定会话,则默认使用当前会话),并从以下类别中寻找改进候选:
- 导航:智能体找到正确文件的难易程度如何?文件之间是否存在隐藏依赖?导航指针是否能让查找更容易?适用于会话花费很长时间才找到某条信息的情况。
- 自动化检查:是否存在能捕获智能体所犯错误的自动化检查?例如 lint、类型检查、测试、文件系统 linter。应先阅读仓库自身的检查命令(其 package.json/构建工具的 lint/check 脚本、CI 工作流),因此“已存在但未接入或静默失效的检查”才是发现,而不是重新发明。一个没有任何护栏(没有 pre-commit 钩子,也没有运行其 lint/typecheck/test 命令的 CI 任务)的仓库本身就是一项发现:未做 lint 的仓库是一个持续存在的错失机会,而非中性的默认状态。适用于智能体犯了本可被自动化检查捕获的错误,或仓库完全没有护栏的情况。
- 编码标准:是否应给审查智能体一条新规则去执行?是否应删除或澄清现有规则?先对违规进行分类:机械性违规(固定的语法模式、被禁用的 API、导入形态、文件位置规则)应获得确定性检查,没有例外:在仓库自己的 linter 中加自定义规则、新增 pre-commit 钩子或新增 CI 任务,取仓库语言和现有护栏下成本最低者。默认构建检查而非撰写规则。CODING_STANDARDS.md 仅保留给真正需要判断的情况(跨文件一致性、“与周围风格匹配”、任何护栏都无法替代的内容)。适用于审查智能体未能捕获错误的情况。
- 全局 AGENTS.md:是否有任何引导指令应改为移入编码标准(或自动化检查)?适用于 AGENTS.md 文件特别大的情况——无论是在仓库中还是用户全局范围内。
- 工具经济性:智能体是否进行了本可精简的昂贵工具调用?是否有任何自定义工具(CLI、MCP)特别消耗 token?适用于智能体进行了昂贵工具调用的情况。
- 无效指令(No-ops):查找引导文件中不改变智能体行为的指令。适用于引导文件庞大且难以驾驭的情况。
- 信息获取:寻找增加智能体信息获取机会的方式。例如 tee 开发服务器日志、对第三方服务的只读访问。适用于智能体无法获得关键信息的情况。
随后按严重程度顺序将这些候选呈现给用户。
使用方式
用户请求回顾时触发。技能会先调用 Skill 工具并传入 writing-for-agents 以获取写作风格指南,然后阅读用户指定会话的原始资料。
实现与审查的区分
所有工作都经过两个阶段:实现与审查。实现智能体承受最大的上下文压力,负责探索、编写代码和调试失败。审查智能体承受最小的上下文压力——它接收 diff,因此无需探索,通常也不需要编写代码或调试。这意味着审查智能体应负责施加编码标准,而非实现智能体。
相关文件
仓库中可访问以下文件:
- CLAUDE.md/AGENTS.md:这些文件会被推送到在此仓库中工作的任何智能体的上下文窗口。应极其节制地使用,通常只用于指向其他文件的导航指针。
- CODING_STANDARDS.md:该文件在审查期间读取,而非实现期间。如果标准文件超过 1,000 行,请添加指向 docs 文件夹的导航指针。
- Docs:将 docs 用作参考文件,由其他文件指向。在编写新文档之前先查找现有文档。
- Skills:将 skills 用于文档(因为其描述会进入智能体的上下文窗口),或用于用户调用的命令。遵循 writing-for-agents 技能中的建议。
适用场景
适用于希望对一次编码会话进行复盘、并据此改进编码智能体运行环境的场景。
限制
资料未提供关于收费、价格、支持平台或具体效果的信息。