SuperAPI AI 工具集

retro

编程与开发

查看项目

更新于 11-07 16:46

技能介绍

用途

retro 技能用于对一次编码会话进行回顾,旨在发现编码代理环境中的改进机会,从而提升未来会话的效率与质量。当用户要求进行回顾时,该技能会分析会话日志,提出具体的环境改进建议。

主要能力

该技能会从以下类别中寻找改进候选:

  • 导航:评估代理查找文件的难易程度,是否存在隐藏依赖,是否可以通过导航指针简化查找。适用于会话中查找信息耗时较长的情况。
  • 自动化检查:识别可捕获代理错误的自动化检查(如 lint、类型检查、测试、文件系统检查)。建议先阅读仓库自身的检查命令(如 package.json 中的脚本、CI 工作流),避免重复造轮子。如果仓库没有护栏(如无 pre-commit 钩子且无 CI 任务运行 lint/类型检查/测试),这本身就是一个发现。适用于代理犯了本可被自动检查捕获的错误,或仓库完全没有护栏的情况。
  • 编码标准:判断是否需要为审查代理添加新规则,或移除/澄清现有规则。对于机械性违规(如固定语法模式、禁用的 API、导入形式、文件位置规则),应优先构建确定性检查(如自定义 lint 规则、pre-commit 钩子或 CI 任务),而非写入文档。仅对需要判断的情况(如跨文件一致性、“匹配周围风格”等)保留 CODING_STANDARDS.md。适用于审查代理未能捕获错误的情况。
  • 全局 AGENTS.md:检查是否有指导指令应移至编码标准或自动化检查中。适用于 AGENTS.md 文件过大(仓库或用户全局范围)的情况。
  • 工具经济性:分析代理是否进行了昂贵的工具调用,是否有可简化的自定义工具(CLI、MCP)存在令牌效率低下的问题。适用于代理进行了昂贵工具调用的情况。
  • 无操作指令:查找指导文件中不改变代理行为的指令。适用于指导文件庞大且笨重的情况。
  • 信息获取:寻找增加代理信息访问的机会,如 tee 开发服务器日志、对第三方服务的只读访问。适用于代理无法获取关键信息的情况。

技能会按严重程度排序向用户呈现这些候选建议。

使用方式

  1. 调用 Skill 工具,使用 writing-for-agents 获取写作风格指南。
  2. 阅读用户指定会话的主要来源(可能涉及搜索本机上的会话日志)。若未指定,默认使用当前会话。
  3. 按上述类别寻找改进候选。
  4. 按严重程度排序呈现给用户。

适用场景

适用于希望优化编码代理工作流程的开发者,特别是在会话效率低下、错误频发或环境配置不完善的情况下。

限制

该技能的具体实现细节、支持的平台、收费情况等暂未提供。使用前需确保具备相应的会话日志访问权限。