SuperAPI AI 工具集

correct

编程与开发

查看项目

更新于 10-16 16:27

技能介绍

Correct 是一个面向代码仓库的智能体纠错技能,来源为 mariusflorescu/pstack-t3,技能页面为 https://www.skills.sh/mariusflorescu/pstack-t3/correct。

用途

该技能解决的是一个反复出现的问题:操作者(operator)在这个仓库里不断因为同一类错误纠正智能体。它的目标不是继续在每次出错时纠正,而是改变仓库本身,让下一个智能体无法再犯下这些错误。

它假设每一位贡献者都是智能体,只能看到自己打开的文件、会复制最近的示例、并选择能编译通过的最短路径。因此仓库设计需要做到:从单个文件看起来正确的改动,对整个仓库来说也是正确的。

主要能力

  1. 找出错误类别:先阅读最近的提交、回滚、评审评论、智能体说明文件,以及解释权宜之计的注释;把错误按类别分组。同一类别出现两次,才算一个类别。

  2. 在最高有效层级修复每一类错误:

    • 用架构消除问题:让每份状态只有一个归属,每项任务只有一条受支持的实现方式;隐藏内部实现,让错误的导入直接失败;用单一事实来源替换手工同步的列表;删除智能体可能会复制的老旧写法与死代码。
    • 用类型约束:让坏状态无法被写出来。
    • 如果坏代码仍能编译,增加 lint 或 CI 检查,并让错误信息直接指出应改用哪个文件、类型或函数。
    • 如果该模式已经很普遍,则只在改动新增更多此类问题时才失败。
    • 测试行为:修复或删除任何“即使它调用的每个函数都返回空也仍然会通过”的测试。
    • 文档或智能体规则放在最后写,只针对需要判断力的场景;智能体跳过它们不会导致任何失败。
  3. 修复并证明:逐个提交修复当前最高频的错误类别;证明每个新增检查能对真实的历史错误失败;在本地和 CI 中运行同一条命令;例外情况写在出错的那一行,并附上原因、失效日期和人工批准。

  4. 维护规则表:最后在智能体说明文件中维护一张表,把每条规则与执行它的机制配对。当操作者纠正你时,修复错误并把规则加进去。如果规则本来就在、却没有任何东西执行它,那就是重复错误,需要在同一次改动中在最高层级修复。当某条规则对应的错误不再可能发生时,就删除该规则。

使用方式

该技能以一套工作流程的形式使用:先读取仓库历史与相关材料(提交、回滚、评审评论、智能体说明文件、权宜注释),归纳错误类别;再按架构、类型、lint/CI、测试、文档的优先级顺序逐层修复;最后按提交落地修复、验证检查、维护规则表。技能结尾要求回复内容包含:每个错误类别及其证据、所选择的层级,以及为什么更高层级不适用。

适用场景

适合在一个由智能体频繁参与贡献、且反复出现同类错误的代码仓库中使用;也适合把“人工反复纠正”转化为“仓库结构性约束”的治理场景。

限制

该技能明确将文档和智能体规则放在最后,且说明智能体即使跳过它们也不会导致失败,因此文档本身不构成强制约束。例外的处理需要人工批准,并需要填写原因与失效日期。该技能未提供具体的命令行示例、安装命令或代码片段;页面未提供这些内容,因此暂未提供。