ESLint 自动修复代理

要解决的问题

在多人协作的 JavaScript/TypeScript 项目中，代码风格和规范问题往往随着迭代不断积累。手动修复每一个 ESLint 警告或错误不仅耗时，还容易遗漏。尤其在提交代码前，开发者希望快速清理掉那些可以被自动修复的 lint 问题，而不是逐条翻阅编辑器的提示。

核心能力

这个技能基于 ESLint v9 flat config 和 ESLint Node.js API，能够自动检测并修复 JS/TS 代码中的 linting 问题。它的核心工作流程包括：

• 调用 ESLint Node.js API 解析项目中的 flat config 配置
• 对目标文件执行 --fix 逻辑，自动修复可修复的规则问题
• 支持通过 lint-staged 处理暂存区文件，避免全量扫描带来的性能开销
• 允许自定义规则配置，适应不同团队的代码规范要求

适用边界

使用前需要注意几点：必须安装 Node.js ^20.19.0、^22.13.0 或 >=24，且需支持 SSL。如果项目使用 TypeScript 类型定义，需要 TypeScript 5.3+。该技能聚焦于 ESLint 可自动修复的问题，对于需要人工判断的逻辑错误或复杂重构无法处理。