retro

用途

retro 是一个回顾复盘技能。当用户要求进行 retrospective 时，该技能用于针对编码智能体的运行环境提出改进建议，以改善未来的运行效果。

主要能力

该技能会读取用户指定会话的原始资料（可能包括本机上的会话日志；若用户未指定会话，则默认使用当前会话），并从以下类别中寻找改进候选：

导航（Navigation）：智能体找到正确文件的难易程度；文件之间是否存在隐藏依赖；导航指针是否能让查找更容易。适用于会话中花费很长时间才找到某条信息的情况。
自动化检查（Automated checks）：是否存在能捕获智能体所犯错误的自动化检查，例如 lint、类型检查、测试、文件系统 linter。应先阅读仓库自身的检查命令（其 package.json/build-tool 的 lint/check 脚本、CI 工作流），因此“已存在但未接入或静默损坏的检查”才是发现，而不是重新发明。一个没有任何护栏（没有 pre-commit 钩子，也没有运行其 lint/typecheck/test 命令的 CI 任务）的仓库本身就是一项发现：未做 lint 的仓库是一个持续存在的错失机会，而非中性默认。适用于智能体犯了本可被自动化检查捕获的错误，或仓库完全没有护栏的情况。
编码标准（Coding standards）：在存在审查阶段时，是否应给其审查者智能体新增一条要执行的规则；是否应删除或澄清现有规则。应首先对违规进行分类：机械性违规（固定的语法模式、被禁用的 API、导入形态、文件位置规则）应获得确定性检查，即仓库自身 linter 中的自定义规则、新的 pre-commit 钩子或新的 CI 任务，取仓库语言与现有护栏下成本最低者。默认应构建检查而非撰写规则。CODING_STANDARDS.md 仅保留给真正需要判断的情况（跨文件一致性、“与周围风格匹配”、任何护栏都无法替代的情形）。适用于审查阶段未能捕获错误的情况。
全局 AGENTS.md：是否有任何引导指令应改为移入编码标准（或自动化检查）。适用于 AGENTS.md 文件特别大时——无论是在仓库中还是用户全局范围内。
工具经济性（Tool economy）：智能体是否进行了可精简的高成本工具调用；是否有任何自定义工具（CLI、MCP）特别消耗 token。适用于智能体进行了高成本工具调用的情况。
无效指令（No-ops）：查找引导文件中不会改变智能体行为的指令。适用于引导文件庞大且难以驾驭的情况。
信息获取（Information access）：寻找增加智能体信息获取机会的方式，例如 tee 开发服务器日志、对第三方服务的只读访问。适用于智能体无法获得关键信息的情况。

该技能会按严重程度顺序将这些候选呈现给用户。

使用方式

用户请求 retrospective 后，技能按以下步骤执行：

调用 writing-for-astra 技能以获取写作风格指南。
读取用户指定会话的原始资料。这可能意味着在本机搜索会话日志。若用户未指定会话，则默认使用当前会话。
在上述类别中寻找改进候选。
按严重程度顺序将候选呈现给用户。

参考：实现与审查

当会话使用不同的实现阶段与审查阶段时，应比较它们实际的输入与职责。实现阶段可能需要探索与调试；审查阶段在验证行为时也可能需要探索。审查阶段可能收到 diff、源文件、测试或运行时证据。其所需的探索与调试取决于审查工作流；不应假定它们不存在。两个阶段都可能提出或应用编码标准。应将候选归因于本次会话中缺少所需证据或权限的那个阶段。

可用文件

仓库中可访问以下文件：

当前 harness 的文档化指令文件（例如 CLAUDE.md 或 AGENTS.md）：用于导航指针与必要约束，遵循 harness 的加载规则。
CODING_STANDARDS.md：根据当前工作流使用；它可能在审查、实现或两者期间被读取。若标准文件超过 1,000 行，应添加指向 docs 文件夹的导航指针。
Docs：将 docs 用作参考文件，由其他文件指向。在撰写新文档前先查找现有文档。
Skills：将 skills 用于文档（因为其描述会进入智能体的上下文窗口），或用于用户调用的命令。遵循 writing-for-astra 技能中的建议。

适用场景

适用于希望对编码会话进行复盘、并据此改进编码智能体运行环境的开发者，尤其是希望发现导航、自动化检查、编码标准、引导文件、工具调用效率与信息获取等方面改进机会的场景。

限制

资料未提供该技能的收费、价格、平台支持范围或具体效果数据。