ESLint 规则分析器与修复器

要解决的问题

团队迭代一段时间后，ESLint 配置往往会「层层叠加」：历史上为了绕过某个报错加的 off 或宽松规则，和新引入的推荐配置互相打架；同一份规则在 .eslintrc 与 flat config 两种体系下语义又不一样。结果是 npx eslint 满屏报错，但没人说清哪条规则在冲突、谁该让路，手动改配置往往越改越乱。

核心能力与工作方式

这个技能直接调用 ESLint 的 Node.js API 与 flat config 体系，把配置解析成可编程的对象，而不是靠文本匹配猜测：

• 冲突定位：逐条比对规则在 plugins、options、severity 上的重叠，列出互相覆盖的规则对，并说明后者覆盖前者的原因。
• 自动修复：对能安全收敛的冲突（如同一文件同一规则被重复定义），按 flat config 的合并语义重写配置，保留人工显式写出的部分。
• 生成共享配置：把收敛后的规则集导出为 shareable config，方便多个项目复用同一套基线。
• 趋势报告：结合多次检查结果输出代码质量趋势，指出质量回退集中在哪些规则或目录，而不是只给一个总数。

关键步骤依次是：加载当前配置并展开 flat config 链 → 模拟解析每个源文件得到规则命中结果 → 归因每条告警到具体规则与配置来源 → 应用可自动修复的变更并生成报告。

适用边界与注意点

• 运行环境需要 Node.js ^20.19.0、^22.13.0 或 >=24，且编译时带有 SSL 支持；官方发行版一般已内置。
• 使用 pnpm 管理依赖时需设置 node-linker=hoisted，否则 ESLint 的插件解析可能找不到 node_modules 里的包。
• 需要 ESLint 的 TypeScript 类型定义时，要求 TypeScript 5.3 或更高版本。
• 自动修复只处理规则层面的冲突；代码里真正的逻辑问题（如未使用变量来自错误导入）仍需人工判断，技能不会替你改写业务逻辑。
• 迁移旧版 .eslintrc 项目时，flat config 对 extends 和插件解析的语义不同，建议先在独立分支上运行分析，再合并结果。