Documentation
README
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. 限定范围修复
This is the opening of the README. Read the full README on GitHub.