用途:在代码评审之后使用,把重复出现的问题转化为确定性 lint 规则,让评审者不必反复标记同一模式。门槛很高:只有能通过 AST 结构(而非启发式)保证捕获特定模式时,才提议规则。
工作流程: 一、识别项目的 linter 栈。按优先级检查配置文件:biome.json/biome.jsonc(biome,仅内置规则)、.oxlintrc.json/oxlint.json(oxlint,支持插件)、.eslintrc./eslint.config.(eslint,支持本地插件)、.grit/grit.yaml(GritQL,完全自定义)、clippy.toml(clippy,有限)、ruff.toml/pyproject.toml [tool.ruff](ruff,仅内置)、.pylintrc(pylint,支持 checker)、.golangci.yml(golangci-lint,有限)。即使已有其他 linter 也要检查 GritQL,因为它能填补不支持插件(biome、ruff)的自定义规则空缺。还要先读现有自定义规则避免重复;若项目既无 linter 也无 GritQL,则停止。
二、评估发现。仅当确定性时保留:匹配具体语法模式(节点类型、属性名、调用签名)、误报近零、不猜测意图与数据流。示例:禁止 eval()、要求 === 替代 ==、禁止 execSync 的模板字面量参数、标记 new Function()、禁止生产代码 console.log、要求导出函数显式返回类型。非确定性(静默跳过):可能含用户输入、函数名暗示敏感数据、通常是 bug、需要运行时或跨文件知识。返回空是常见预期。
三、提议规则。优先内置规则,其次 GritQL,最后自定义插件。内置示例:biome 配置 rules 下 suspicious/complexity/style 等;eslint 用 "no-eval": "error"、"eqeqeq": ["error", "always"];oxlint 用兼容 eslint 的规则名。GritQL 放 .grit/grit.yaml,通过 grit check 强制、grit apply 自动修复,标准库有 200+ 模式,可自定义禁止 eval 模板、execSync 插值等。eslint/oxlint 可写本地插件规则并在 config 中引用。
集成:在评审工作流中接收评审代理的发现,过滤确定性候选,按决策树提议规则,并作为独立的“自动化机会”章节呈现。原则:确定性优先、已有规则优先、缺口用 GritQL、遵循项目惯例、空输出可接受、不确定某规则是否存在时先用 Context7 查文档。限制:需要类型信息或跨文件上下文的模式无法处理。