ESLint 修复助手

ESLint 修复助手

工作流程

1. 识别项目工具链

读取：

• package.json 中的 scripts、devDependencies 和 packageManager。
• npm、pnpm、Yarn 或 Bun 的 lockfile。
• eslint.config.*、.eslintrc.*、.eslintignore、Prettier 和 TypeScript 配置。
• 适用的仓库规则、Git 状态和用户指定的文件范围。

优先运行仓库已有的 lint script。只有确认 ESLint 已被当前项目锁定并安装时，才使用对应包管理器的本地执行方式。若缺失依赖，先报告；安装包、更新 lockfile 或迁移配置需要单独授权。

2. 建立只读基线

先对用户指定或本轮相关范围运行不修改文件的检查，记录：

• 实际命令、ESLint 版本和退出状态。
• error / warning 数量、涉及文件和规则。
• 基线中已有的问题与本轮引入的问题。

不要默认扫描整个大型仓库，也不要用未锁定依赖、可能联网下载新版本的 npx 调用。

3. 预览可修复范围

• 使用项目现有命令支持的 --fix-dry-run、JSON 输出或等价能力判断预计改动。
• 检查当前 Git diff，确认目标文件没有与用户修改重叠。
• 区分可自动修复、需要理解代码语义、需要配置决策三类问题。
• 展示预计修改范围；可能产生大面积格式 diff 或改变逻辑时先取得确认。

4. 限定范围修复

• 只对已确认的文件执行 --fix，不自动扩大到整个仓库。
• 对 no-explicit-any、未处理 Promise、React Hooks 依赖等语义规则，结合类型、调用方和运行路径修改，不能机械替换。
• 不为消除报错而默认禁用规则、加入全局 ignore、修改 formatter 顺序或降低严重级别。
• Prettier 与 ESLint 的执行顺序以项目现有 scripts 和集成配置为准。

常见可自动修复规则包括 semi、quotes、indent、no-trailing-spaces、comma-dangle、arrow-parens 和 prefer-const；dry-run 和 diff 只能预览改动，最终仍需按风险运行类型检查、测试或构建。