SuperAPI AI 工具集

jev-lint

写作与研究

查看项目

更新于 10-16 06:48

技能介绍

用途:jev-lint 把“规则写成句子”。ast-grep 负责确定要看哪些代码,一句自然语言决定它是否是问题,模型(Jev)对每个匹配项按文件批量作答。它针对的是编译器、类型检查器和常规 linter 无法判定的问题,例如函数体做的事与函数名承诺不符、注释已变成假话、测试在被测行为被破坏时仍会通过。

主要能力与限制:不要编写编译器、类型检查器或常规 linter 能判定的规则;不要问匹配代码无法展示的内容;不要把阈值写进句子,阈值应写 threshold:。API key 放在环境变量 TYPESAFE_API_KEY(或 TYPESAFEAI_API_KEY)中,不得写进 .jev-lint.yaml,文件中出现 apiKey: 是硬错误。约每五条发现中有一条是错的,发现只是供人复核的候选,不是结论。

常用命令:npx -y jev-lint check src --dry-run(只规划与报价,不发请求);npx -y jev-lint check src;npx -y jev-lint run fn-name-promises src;npx -y jev-lint run --file myrule.yml src;npx -y jev-lint review --base main;npx -y jev-lint commits --base main;npx -y jev-lint commits --staged;npx -y jev-lint init;npx -y jev-lint rules。建议先 --dry-run,日常优先用 review 而不是 check。退出码:0 干净,1 有发现,2 配置错误,3 请求失败。可用 --retry 3 取三次均值,--threshold 覆盖单次阈值,--format github 用于 CI,-R 指定规则来源。

配置:.jev-lint.yaml(或 jev-lint.yaml、.jevlint.yml,同目录两份为错误),向上查找最近一份,命令行参数优先。languages: 声明 ast-grep 未内置的语法;files: 使 check 可无参数;rules: 以 ESLint 风格选择规则;无 rules: 则什么都不跑,未知键为错误。缓存位于 .jev-lint/baseline.json。

适用场景:仓库与 CI 中的代码审查、提交信息与 diff 对照、变更与仓库自身 AGENTS.md 对照、自定义规则与阈值校准。支持任意注释语法的忽略标记,如 // jev-lint-ignore-next-line、// jev-lint-ignore-file。

暂未提供:具体价格数值、支持的全部平台与语言列表、官方安装之外的详细信息。