SuperAPI AI 工具集

taste-to-checks

编程与开发

查看项目

更新于 11-11 13:51

技能介绍

Taste to Checks 是一种把“我们反复对智能体输出做出的审查修正”转化为可独立运行的检查的实践方法。资料给出的核心判断是:如果同一件事需要对智能体说两次,第二次就是人的责任;只存在于人脑中的品味必须在每次审查时手动应用,无法随会话数量扩展,因此应写下来并放在能自动运行的地方。

用途:把重复出现的审查意见固化为自动化约束,减少人工审查负担,避免同一问题在新会话或上下文压缩后再次发生。

五步流程:

  1. 捕捉重复:识别应转为检查的信号,例如在两条智能体 PR 上写了相同的审查评论、在压缩后或新会话中再次出现同样问题、证据优先审查发现的、机械检查本可捕获的遗漏。一次性怪癖不纳入,只编码已发生多次或造成实际损害的内容。
  2. 写成一句可测试的规则:反例是“保持代码整洁”;正例包括“packages/core 中不得新增 any”“每个新工具的 description 少于 200 字符”“修复 bug 的 PR 包含一个在 main 上会失败的测试”。无法测试化的属于判断性事项,保留在人工审查中。
  3. 选择最强的落点:禁止的代码模式放入 lint 规则或 CI 中的 grep,并在错误信息中指明修复方式;必须成立的行为写成先在坏版本上失败的测试;每次编辑或提交都必须发生的事放入 hook(pre-commit 或 MiniMax Code hook);需要上下文而非机械判断的放入项目规则(AGENTS.md)或技能,作为最后手段。优先选择表格靠上的位置,因为 AGENTS.md 中的文字会被阅读但有时被忽略,而失败的检查不会被忽略。
  4. 证明检查有效:对过去的错误运行检查,检出该提交或重新应用坏 diff,确认其以清晰信息失败;再确认在当前 main 上通过。从未失败过的检查不能证明有效。
  5. 小步交付:每个 PR 只包含一条规则,并在描述中链接其来源的审查评论或事件。

输出物:规则句子、落点位置、证明其在旧错误上失败且在 main 上通过的运行命令,以及 PR 链接。

适用场景:智能体辅助的软件开发与代码审查流程,尤其是需要将团队审查品味规模化、减少重复人工修正的工程团队。

限制:资料未提供具体工具实现、安装命令、平台支持范围或收费信息;该方法依赖团队已有 lint、CI、测试与 hook 基础设施。