SuperAPI AI 工具集

retro

编程与开发

查看项目

更新于 10-28 16:12

技能介绍

retro 是一个用于对编码会话进行复盘的技能。其目标是:在会话结束后,为编码智能体的工作环境提出改进建议,从而改善后续运行效果。

用途 用户请求复盘时使用本技能。默认回顾当前对话;如需其他会话的历史,可通过 /recall 获取,并保留其明确的仓库与时间范围。复盘过程中会调用 /domain-modeling 解析和读取项目已配置的产出物;仅当任务授权修改时,才通过该负责方持久化已接受的模型变更。委派工作使用 /swarm,并采用实际宿主 schema、隔离写入方和已披露的降级方案。写作风格遵循 /writing-for-agents。

主要能力(改进候选类别)

  • 导航:智能体是否容易找到正确文件、文件间是否存在隐藏依赖、是否需要导航指针。适用于会话中查找信息耗时较长的情况。
  • 自动化检查:能否用 lint、类型检查、测试、文件系统 linter 等捕获智能体所犯错误。应先阅读仓库自身的检查命令(package.json 或构建工具的 lint/check 脚本、CI 工作流),若检查已存在但未接入或静默失效,问题应定位为该检查;没有任何护栏(无 pre-commit 钩子且无运行 lint/typecheck/test 的 CI 任务)本身即为发现项。
  • 编码标准:评审智能体是否应新增、删除或澄清规则。先对违规分类:机械性违规(固定语法模式、禁用 API、导入形态、文件位置规则)应优先做确定性检查(仓库 linter 自定义规则、新 pre-commit 钩子或新 CI 任务,取决于语言与现有护栏中成本最低者),默认优先构建检查而非写规则;CODING_STANDARDS.md 仅用于真正需要判断的场景(跨文件一致性、与周边风格一致等)。
  • 全局 AGENTS.md:是否应把某些引导指令迁移到编码标准或自动化检查中。适用于仓库或用户全局范围的 AGENTS.md 过大时。
  • 工具经济性:智能体是否有可精简的高成本工具调用,是否存在 token 效率低的自定义工具(CLI、MCP)。
  • 无效指令(No-ops):引导文件中不改变智能体行为的指令。适用于引导文件庞大臃肿时。
  • 信息获取:为智能体增加信息访问的机会,如 tee 开发服务器日志、对第三方服务的只读访问。适用于关键信息不可用时。

使用方式 按上述步骤读取会话主要来源,寻找各类候选改进,按严重程度向用户呈现。完成标准:每条建议都引用已观察到的失败或摩擦,指明现有负责方和最小有效改动,并区分“提议”与“已应用改动”。在当前授权范围内准备由学习驱动的指令修改以供审阅。

适用场景 编码会话结束后的复盘与智能体环境改进,尤其适合需要将重复出现的错误转化为自动化检查、精简引导文件、降低工具调用成本的情况。

限制与说明 资料强调实现与评审两阶段分工:实现智能体上下文压力最大,负责探索、写代码和调试失败;评审智能体上下文压力最小,通常只需接收 diff,因此应由评审智能体负责施加编码标准。CLAUDE.md/AGENTS.md 应极其克制地使用,通常只放指向其他文件的导航指针;CODING_STANDARDS.md 在评审时读取,超过 1000 行时应添加指向文档目录的导航指针;文档应作为被其他文件指向的参考文件,优先复用已有文档;技能可用于文档(其描述会进入智能体上下文窗口)或用户调用的命令。其他具体功能、收费、平台支持等细节暂未提供。