关于 retro
面向编码 Agent 的回顾技能，通过检查会话记录，提出改进 Agent 工作环境的建议。评估范围包括导航、自动检查、编码规范、工具使用、指令和信息访问。
主要功能
- 01检查会话来源
- 02识别环境改进机会
- 03评估自动检查与防护机制
- 04审视编码规范和指令
- 05检查工具效率与信息访问
适用场景
- 01查找编码会话问题的成因
- 02提出仓库导航指引
- 03发现缺失或未接入的检查
- 04减少高成本工具调用
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/retro确认已加载。
附带文件agents/openai.yamlCREDITS.md
详细介绍
复盘
用户要求进行一次复盘。你要为编码 Agent 的环境提出改进建议，以优化之后的运行。
步骤
-
调用 Skill 工具，使用
writing-for-agents获取写作风格指南。 -
阅读用户指定会话的主要来源。这可能需要在本机搜索会话日志（Claude Code：
~/.claude/projects/；Codex：~/.codex/sessions/）。如果用户没有指定会话，则默认使用当前会话。 -
在以下类别中寻找可改进之处。
- 导航：Agent 找到正确文件的难度如何？文件之间是否存在隐藏依赖？添加导航指引能否让查找更容易？适用情况：会话花了很长时间才找到某条信息。
- 自动化检查：是否有自动化检查可以捕获 Agent 犯下的错误？例如 lint、类型检查、测试、文件系统 lint。首先阅读仓库自身的检查命令（
package.json中的lint/check/build脚本、已提交的.luarc.json、CI 工作流），所以，如果某项已有检查未接入或悄然失效，问题就在于此，而不是需要重新发明检查。对于 Lua，应使用带有 fivem-lls-addon 的 LuaLS，它能识别 natives 和 CfxLua 语法，并可通过lua-language-server --check无头运行；会拒绝反引号哈希或+=的标准 Lua linter 属于失效的检查，不应因此放弃这些语法。如果仓库没有防护措施（没有 pre-commit hook，也没有 CI 作业运行 lint、类型检查或测试命令），这本身就是一个发现：没有 lint 防护的仓库意味着持续错失改进机会，而非中立的默认状态。适用情况：Agent 犯下了自动化检查本可发现的错误，或仓库完全没有防护措施。 - 编码规范：是否应给审核 Agent添加一条新规则？是否应删除或澄清现有规则？首先对违规进行分类：机械性违规（固定的语法模式、禁用的 API 或 native、导入形式、文件位置规则）应始终通过确定性检查处理：根据仓库语言和现有防护措施，选择成本最低的方式，例如在仓库自己的 linter 中添加自定义规则、新增 pre-commit hook，或新增 CI 作业。默认优先构建检查，而不是编写规则。只有真正需要判断的情况（跨文件一致性、“符合周边风格”之类的要求，以及任何防护措施都无法替代的内容）才写入
CODING_STANDARDS.md。适用情况：审核 Agent 未能发现错误。 - 全局 AGENTS.md：是否有应移至编码规范（或自动化检查）的指导说明？适用情况：仓库或用户全局范围内的
AGENTS.md文件特别庞大。 - 工具使用效率：Agent 是否进行了可以精简的高成本工具调用？是否有特别耗费 token 的自定义工具（CLI、MCP）？子 Agent 使用的模型是否对其职责而言过大或过小？适用情况：Agent 进行过高成本的工具调用。
- 无效指令：指导文件中的指令是否未能改变 Agent 的行为？适用情况：指导文件庞大且难以维护。
- 信息获取：是否有办法让 Agent 获取更多信息？例如，将 FXServer 控制台输出同时写入 Agent 可读取的文件，或提供数据库及第三方服务的只读访问权限。适用情况：Agent 无法获取某项关键信息。
- 按严重程度排序，向用户展示这些候选项。
参考
实现与审查
请记住，所有工作都分为两个阶段：实现和审查。实现 Agent 面临最大的上下文压力。他们负责探索、编写代码和调试故障。
审查 Agent 面临的上下文压力最小：他们会收到差异，因此无需探索。他们通常也不需要编写代码或调试。
这意味着，制定编码标准应由审查 Agent 负责，而不是实现 Agent。
文件
你可以访问仓库中的多个文件：
CLAUDE.md/AGENTS.md：这些文件会被加入在此仓库中工作的任何 Agent 的上下文窗口。应极其谨慎地使用，通常只用于提供指向其他文件的导航指引。CODING_STANDARDS.md：此文件会在审查期间读取，而非实现期间读取。如果标准文件超过 1,000 行，请添加指向文档文件夹的导航指引。- 文档：将文档用作由其他文件指向的参考文件。编写新文档前，请先查找现有文档。
- 技能：将技能用于文档（因为其描述会进入 Agent 的上下文窗口），或用于用户调用的命令。遵循
writing-for-agents技能中的建议。 .ox/config.md和~/.config/ox/models.md：项目事实（资源、版本、框架）以及 ox 技能读取的各角色子 Agent 模型。如果会话出错是因为其中某个文件内容过时，应告知用户运行/setup-ox project或/setup-ox models来修复，而不是新增指令。
评论
支持 Markdown