SuperAPI AI 工具集

correct

编程与开发

查看项目

更新于 11-01 17:53

技能介绍

用途 Correct 用于治理代理在代码仓库中重复犯下的同类错误。它的思路不是继续在对话里纠正代理,而是改变仓库本身,使下一位代理无法再犯同样的错误。

前提假设 该技能假设每位贡献者都是代理:它只看到自己打开的文件,会复制最近的示例,并选择能通过编译的最短路径。因此仓库需要设计成“从单个文件看是正确的改动,对整个仓库也是正确的”。

主要能力

  • 识别错误类别:阅读最近的提交、回滚、评审意见、代理指令文件以及解释变通做法的注释,将错误归组;同一类错误发生两次才计为有效类别。
  • 按最高可行层级修复:优先用架构消除错误,例如让每份状态只有一个所有者、每项任务只有一种受支持的做法、隐藏内部实现使错误导入失败、用单一事实来源替代手工同步列表、删除代理可能复制的旧方式和死代码。
  • 用类型约束:使错误状态无法被写出。若错误代码仍能编译,则增加 lint 或 CI 检查,且错误信息需指明应使用的文件、类型或函数。若该模式已普遍存在,可只对新增违规报错。
  • 测试行为:修复或删除那些在所检查行为被破坏时仍通过、或仅在内部实现变化时失败的测试。
  • 最后写文档或代理规则:仅用于需要判断的场景,且不依赖“代理会主动阅读”来保证执行。

使用方式 先修复当前最频繁的错误类别,每类一个提交。为每个新检查提供证明:它在真实的历史错误上会失败;同一命令在本地和 CI 中运行。例外需标注在违规行上,并附原因、到期日期和人工批准。最后在代理指令文件中维护一张规则与执行方式对照表;当操作者纠正时,修复错误并补充规则;若规则已存在但无任何执行手段,视为重复错误,在同一改动中按最高层级修复;当某类错误已不可能发生时可删除对应规则。

适用场景 适用于由代理参与贡献、且存在重复错误模式的代码仓库,尤其是需要把口头纠正转化为结构性约束的团队。

限制 资料未提供具体支持的编程语言、平台、安装命令或集成方式,暂未提供。输出要求包括按类别给出证据、所选层级以及更高层级不可行的原因。