SuperAPI AI 工具集

correct

编程与开发

查看项目

更新于 11-06 21:02

技能介绍

Correct 是一个用于治理代码仓库中智能体重复错误的技能。它的核心目标是:当操作者反复纠正智能体在某个仓库中犯下的相同错误时,不再只是口头纠正,而是修改仓库本身,使下一个智能体无法再犯同样的错误。

用途

该技能假设每一位贡献者都是智能体:它只能看到自己打开的文件,会复制最近的示例,并选择能编译通过的最短路径。因此,仓库需要被设计成“从单个文件看起来正确的改动,对整个仓库也是正确的”。Correct 用于发现并消除那些反复出现的错误类别。

主要能力

  1. 发现错误类别:阅读最近的提交、回滚、评审评论、智能体指令文件以及解释变通方法的注释,将错误归类。一个类别在发生过两次后才算成立。
  2. 在最高可行层级修复:优先用架构消除错误,例如让每份状态只有一个所有者、每项任务只有一种受支持的方式、隐藏内部实现使错误导入失败、用单一事实来源替代手工同步的列表、删除智能体会复制的旧方式和死代码。
  3. 用类型强制约束:让错误状态无法被写出。如果坏代码仍能编译,则添加 Lint 或 CI 检查,其错误信息应指明应使用的文件、类型或函数。如果该模式已经普遍存在,则只在改动新增更多此类问题时失败。
  4. 测试行为:修复或删除那些在行为被破坏时仍然通过、或仅在内部实现变化时就失败的测试。
  5. 文档与规则最后写:仅用于需要判断的场景,智能体跳过它们不会导致失败。

使用方式

首先,每个会话阅读一次宿主适配器,再遵循该技能。宿主适配器会把上游 Cursor 专用的工具、模型、路径和权限指令映射到当前宿主,并设定权限边界。

然后修复并证明:按频率从高到低修复错误类别,每个类别一个提交。证明每个新检查能在真实的历史错误上失败。在本地和 CI 中运行相同的命令。例外情况需写在出错行上,并附上原因、到期日期和人工批准。

最后,维护规则表:在智能体指令文件中保留一张表,将每条规则与其强制手段配对。当操作者纠正你时,修复错误并添加规则。如果规则已存在但没有任何强制手段,那就是重复问题,应在同一次改动中于最高层级修复。当某个错误已不可能发生时,删除对应规则。

适用场景

适用于由智能体参与贡献、且操作者反复纠正同类错误的代码仓库。适合希望将纠错从“口头提醒”升级为“仓库级约束”的团队。

限制

资料未提供具体的安装命令、支持的平台、收费方式或价格信息。该技能依赖宿主适配器来映射工具与权限,具体适配范围暂未提供。