ESLint 规则执行代理

解决什么问题

团队项目里，ESLint 规则往往「配置了但没人执行」。要么开发者手动跑 npx eslint 忘了加 --fix，要么修复风格不统一，CI 里才暴露一批风格问题，补丁来回反复。这个技能要解决的就是把「检查—修复—回归」这条链路从手工操作里剥离出来，让规则执行成为可重复、可脚本化的一步。

如何工作

技能基于 ESLint Node.js API 和 @typescript-eslint/parser 构建，核心能力分三层：

• 配置解析：读取项目的 ESLint 配置（含共享配置继承），解析出生效的规则集，不依赖开发者在命令行里临时指定参数。
• 规则执行与诊断：遍历 JavaScript / TypeScript 源文件，产出结构化的诊断信息，区分可自动修复项与需人工判断项。
• 修复建议与自动纠正：对支持 fix 的规则（如缩进、引号、未使用变量等）直接应用修复补丁；不支持自动修复的（如复杂语义冲突）则输出定位明确的修改建议，交由开发者决策。

对 TS 代码，解析阶段交给 @typescript-eslint/parser，保证类型感知的规则能拿到正确的 AST。

适用边界与注意点

• Node.js 版本是硬性门槛：需要 ^20.19.0、^22.13.0 或 >=24，且编译时带 SSL 支持。官方发行版通常已内置。
• TypeScript 类型定义：如果要用 ESLint 的 TS 类型定义，要求 TypeScript 5.3 或更高。
• Pnpm 用户注意：node-linker 需要设为 hoisted，否则 ESLint 在 pnpm 布局下可能找不到规则包。
• 不是 linter 替代品：技能执行的是 ESLint 规则集，规则质量仍取决于团队自己的配置，配错了规则，修复结果也会错。
• 复杂修复仍需人工 review：自动纠正覆盖的是规则明确支持的部分，涉及跨文件或语义层的问题，建议只当作起点，不要直接合并。