JavaScript 错误检查与修复器
触发映射
| 用户输入触发词 |
AI 执行动作 |
| "检查 JS 错误" / "修复 JS 问题" / "JS 语法错误" |
按【检查修复模式】执行 |
| "检查文件夹" / "批量处理 JS" / "修复所有 JS" |
按【批量处理模式】执行 |
| "检查这个文件" / "修复这个 JS" |
按【单文件模式】执行 |
执行模式
检查修复模式
触发：用户提到检查或修复 JS 错误
| 步骤 |
执行动作 |
具体命令/操作 |
| 1 |
检查 ESLint 配置 |
检查项目是否已安装 ESLint 和配置文件 |
| 2 |
安装 ESLint（如需要） |
运行 npm install --save-dev eslint globals 安装依赖 |
| 3 |
配置 ESLint（如需要） |
创建 eslint.config.js 配置文件 |
| 4 |
运行 ESLint 检查 |
执行 npx eslint <路径> 检查 JS 文件 |
| 5 |
分析错误 |
分类统计错误：语法错误、类型错误、其他 |
| 6 |
创建待办 |
运行 TodoWrite 创建修复任务列表 |
| 7 |
逐个修复 |
按优先级逐个修复文件，使用 Read 和 SearchReplace |
| 8 |
验证修复 |
再次运行 ESLint 确认错误已修复 |
| 9 |
输出报告 |
列出修复的文件和错误类型 |
批量处理模式
触发：用户提到文件夹或批量处理
| 步骤 |
执行动作 |
具体命令/操作 |
| 1 |
获取目录路径 |
询问用户或从上下文获取目标文件夹路径 |
| 2 |
查找 JS 文件 |
运行 Glob 搜索 **/*.js 文件 |
| 3 |
检查 ESLint |
运行 ESLint 检查所有 JS 文件错误 |
| 4 |
创建待办 |
运行 TodoWrite 列出所有待修复文件 |
| 5 |
批量修复 |
循环处理每个有错误的文件 |
| 6 |
验证结果 |
再次运行 ESLint，输出修复报告 |
单文件模式
触发：用户指定某个 JS 文件
| 步骤 |
执行动作 |
具体命令/操作 |
| 1 |
获取文件路径 |
从用户输入或上下文获取文件路径 |
| 2 |
读取文件 |
运行 Read 读取该文件内容 |
| 3 |
检查 ESLint |
运行 ESLint 检查该文件的错误 |
| 4 |
分析问题 |
定位具体错误位置和类型 |
| 5 |
执行修复 |
使用 SearchReplace 或重写文件修复 |
| 6 |
验证修复 |
再次运行 ESLint，确认修复完成 |
ESLint 配置指南
安装 ESLint
| 步骤 |
操作 |
命令 |
| 1 |
进入项目目录 |
cd <项目路径> |
| 2 |
安装 ESLint |
npm install --save-dev eslint |
| 3 |
安装 globals 包 |
npm install --save-dev globals |
创建 ESLint 配置文件
创建 eslint.config.js 配置文件（flat config 格式）：
import globals from "globals";
export default [
{
languageOptions: {
ecmaVersion: "latest",
sourceType: "module",
globals: {
...globals.node,
...globals.es2022
}
},
rules: {
"no-undef": "error",
"no-unused-vars": "warn",
"semi": [
"error",
"always"
],
"quotes": [
"error",
"double"
]
}
}
];
运行 ESLint 检查
| 检查范围 |
命令 |
| 检查单个文件 |
npx eslint <文件路径> |
| 检查整个目录 |
npx eslint <目录路径> |
| 检查当前目录所有 JS |
npx eslint . |
常见错误修复策略
| 错误类型 |
错误表现 |
修复方式 |
| HTML 实体编码 |
特殊字符被编码 |
将编码字符替换为实际字符 |
缺少右括号 ) |
诊断提示"应为')'" |
找到对应左括号位置，在正确位置添加 ) |
缺少分号 ; |
诊断提示"应为';'" |
在语句末尾添加 ; |
| 引号不匹配 |
字符串引号未闭合 |
检查字符串，补全闭合引号 |
| 花括号不匹配 |
{ 和 } 数量不匹配 |
找到缺失的 { 或 } |
| 变量未定义 |
使用了未声明的变量 |
检查变量作用域，添加声明或修正拼写 |
错误处理
| 错误场景 |
错误表现 |
处理方式 |
| 无 JS 文件 |
Glob 搜索结果为空 |
提示用户未找到 JS 文件，询问是否调整路径 |
| 无 ESLint 错误 |
ESLint 返回空 |
输出"未发现错误"，结束任务 |
| 文件无法读取 |
Read 返回错误 |
跳过该文件，记录到报告，继续处理其他文件 |
| 修复后仍有错误 |
修复后 ESLint 仍有问题 |
标记为"需要人工检查"，继续处理其他文件 |
| 未安装 ESLint |
npx eslint 失败 |
先安装 ESLint 和 globals 包 |
核心法则检查表
| 法则 |
检查标准 |
通过？ |
| ⭐⭐⭐ 人类中心 |
用户只需说自然语言，AI 自动执行检查和修复 |
✅ |
| ⭐⭐⭐ AI 优先 |
使用祈使句指令，表格展示决策逻辑 |
✅ |
| ⭐⭐⭐ 即调即用 |
有触发映射表，用户输入 → AI 动作一一对应 |
✅ |
| 渐进披露 |
核心内容简短 |
✅ |
| 错误处理 |
包含常见错误场景和处理方式表格 |
✅ |