SuperAPI AI 工具集

abide-compile

编程与开发

查看项目

更新于 11-15 00:39

技能介绍

用途

abide-compile 用于把人工写给编码智能体的指令文件,转换成由外部检查器逐次编辑执行的 rubric(规则集)。检查器每次只看到一条规则和一个 diff,因此编译过程要求规则具体、可追溯。

主要能力

  • 读取 hook 列出的全部指令文件,包括指向型文件和子目录范围文件。
  • 逐条提取含指令性的句子,保留用户原文、来源路径与行号,并附带相邻代码示例。
  • 将每条规则分入四类:lint(可由 linter 精确执行)、mechanical/deferred(需要计数或测量、需要仓库上下文)、model(仅凭一次改动即可判断)、unenforceable(关于对话或流程)。
  • 为 model 类规则编写 boolean、choice 或 score 类型的具体问题,设置 scope 与 when(edit 或 turn)。
  • 输出 .abide/rubric.json(全局文件为 ~/.abide/global.json),并通过 abide rubric validate 与 abide calibrate 校验、校准;校准会把过弱或噪声过大的规则标记并停用。

使用方式

按步骤读取源文件、提取规则、分类、编写问题、确定运行时机、写出 JSON 文件,然后运行: abide rubric validate(加 --global 处理全局文件) abide calibrate(同上) 校验问题修复后重跑;校准后对弱规则或噪声规则只重写一次,不再循环。最后用两三句话向用户汇报规则数量、四类分布、被停用的规则以及规则文件位置,不把 rubric 粘贴到对话中。

适用场景

适用于已有 AGENTS.md、CLAUDE.md、CONTRIBUTING.md 或 lint 配置等指令文件,希望将其转化为可审计、可手工编辑的检查规则的仓库。

限制

规则只能来自用户文件,不得自行添加;无法由单次 diff 判断的规则标为 deferred 或 unenforceable;校准依赖仓库 git 历史,无历史时跳过;不运行 linter,仅记录 lint 规则名。