ESLint 规则配置器

要解决的具体问题

手动编写 eslint.config.js 时，开发者需要反复核对官方预设、TypeScript 生态规则和 import 插件的默认行为。一旦项目同时使用 @eslint/js、typescript-eslint 与 eslint-plugin-import，规则覆盖顺序和冲突解决就会变成纯体力活：no-unused-vars 与 @typescript-eslint/no-unused-vars 哪个优先生效？import 规则的路径解析要不要交给 TypeScript 的 moduleResolution？这类问题在大型仓库中往往要花掉整个下午。

核心能力与工作流程

该技能围绕“生成优化配置 + 代码库分析”两条主线展开。

• 集成官方预设：直接复用 @eslint/js 的 recommended 配置，避免手写基础规则集。
• 推荐规则集：结合 typescript-eslint 与 eslint-plugin-import 的推荐规则，生成覆盖 TypeScript 与模块解析场景的 flat config 骨架。
• 处理 TypeScript 类型：如果项目使用 ESLint 的 TypeScript 类型定义，会提示需要的 TypeScript 版本。

工作流程分为三步：

1. 根据项目依赖生成 eslint.config.js 的初始结构，自动插入 @eslint/js 和 typescript-eslint 的配置入口。
2. 扫描代码库中的导入路径、函数签名与文件组织方式，推断需要开启的 import 规则（如 no-extraneous-dependencies）。
3. 在配置中输出注释说明规则来源，方便开发者后续手动微调。

适用边界与注意事项

• 需要 Node.js ^20.19.0、^22.13.0 或 >=24，且编译时包含 SSL 支持（官方发行版默认满足）。
• 若启用 TypeScript 类型定义，要求 typescript 版本不低于 5.3。
• 推荐在 Yarn PnP 或 Nx 等工具链中设置 node-linker=hoisted，避免模块解析异常。
• 分析阶段只覆盖代码结构特征，不会读取业务语义，因此生成的推荐规则仍需人工复核。