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 动作一一对应 | ✅ |
| 渐进披露 | 核心内容简短 | ✅ |
| 错误处理 | 包含常见错误场景和处理方式表格 | ✅ |
