ESLint 规则强制执行代理

解决什么问题

项目代码规范往往散落在 .eslintrc、CI 脚本和 PR 审查意见里。开发者常见的痛点是：规则只在本地跑，合并后才发现 import 顺序、未使用变量、复杂度阈值等工程约束被绕过；而 ESLint 的逐行报错又很难直接变成可提交的修复。这个技能面向需要把项目特定标准固化下来的场景：不是一次性 lint 扫描，而是把违规结构化，并产出能交给 git apply 的修复补丁。

核心能力与关键步骤

• 加载自定义规则集：通过 ESLint Node.js API 运行 lint，并结合 eslint-plugin-import 检查模块导入顺序与依赖问题。
• 解析 AST 违规：从 ESLint 结果中提取 file、line、column、ruleId、severity 和 message，避免只打印一段不可检索的文本。
• 按严重度分组：将 error 与 warning 分开，方便在 PR 评论、任务单或 CI 摘要中区分阻塞项和建议项。
• 生成可修复补丁：利用 eslint --fix 的输出，与原文件做 diff，得到可直接应用的修复补丁；无法自动修复的问题仍会保留在报告里。

适用边界

• 它能处理 ESLint 规则本身支持的可修复问题，例如格式、排序、简单导入规则；不能替代语义审查、测试或架构判断。
• 运行环境需要 Node.js ^20.19.0、^22.13.0 或 >=24，且带有 SSL 支持；官方 Node.js 发行版通常已内置。
• 如果项目使用 TypeScript 类型定义，需要 TypeScript 5.3 或更高版本。
• node-linker=hoisted 会影响 monorepo 的依赖布局，接入前应确认与现有构建方式兼容。