@wwkit/harness 1.0.8 → 1.0.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wwkit/harness",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "author": "bluesliu <langcai163@163.com>",
   "description": "WebWork abilities for opencode",
   "type": "module",
@@ -38,7 +38,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@opencode-ai/plugin": "1.18.27",
+    "@opencode-ai/plugin": "1.18.30",
     "ajv": "^8.17.0",
     "cheerio": "^1.0.0",
     "json5": "^2.2.3"

package/skills/better-skill/SKILL.md

@@ -0,0 +1,124 @@
+---
+name: better-skill
+description: |
+  基于 blame-skill 审计评分，自动迭代优化 Skill 定义文件直到达到优秀等级。
+  提供：迭代优化流程、自动改进策略、评分达标验证。
+  适用：新建 Skill 后自动优化、已有 Skill 质量提升、批量 Skill 质量治理。
+  不适用：非 SKILL.md 文件优化、Agent 定义优化、无需评分的简单修改。
+license: MIT
+---
+
+# Skill 自动优化器
+
+## 工作流模式
+
+本 Skill 采用 **迭代优化** 工作流：
+
+1. **评估**：调用 blame-skill 对目标 Skill 进行审计评分
+2. **判断**：检查分数是否 >= 90（A 级）或已达最大迭代次数
+3. **改进**：根据审计报告的改进建议，修改目标 SKILL.md
+4. **重评**：再次调用 blame-skill 重新评估
+5. **循环**：重复步骤 2-4 直到达标或累计迭代 5 次
+
+## 输入要求
+
+用户必须提供要优化的 **skill 名称**（如 `git-feat`、`clean-code`）。
+
+## 迭代流程
+
+### 第 1 步：初始评估
+
+调用 blame-skill 对目标 Skill 进行审计评分，使用 `--format=json` 结构化模式获取结果：
+
+- 读取 blame-skill 的评分规则
+- 按路径顺序查找目标 SKILL.md
+- 逐项评分并生成结构化审计报告
+
+### 第 2 步：达标判断
+
+从审计结果中提取 `total_score`：
+
+| 条件 | 动作 |
+|------|------|
+| `total_score >= 90` | 输出最终报告，流程结束 |
+| `total_score < 90` 且迭代次数 < 5 | 进入第 3 步改进 |
+| `total_score < 90` 且迭代次数 >= 5 | 输出最终报告（含未达标说明），流程结束 |
+
+### 第 3 步：改进 Skill
+
+根据审计报告中的 `issues` 和 `improvement_priority`，对目标 SKILL.md 进行修改：
+
+1. 按 `improvement_priority` 顺序逐项处理
+2. 对每个 issue，将 `suggestion` 转化为具体的文件修改操作
+3. 修改时遵循以下原则：
+   - **Frontmatter**：补充/修正 name、description 字段，确保 description 在 50-300 字符且包含具体能力、适用场景、不适用场景、提供资源
+   - **工作流声明**：在正文开头添加明确的工作流模式声明
+   - **失败处理**：补充失败处理机制（回滚、重试、降级、人工介入）
+   - **正文结构**：使用标题、列表、表格等结构化格式，补充代码示例和边界说明
+   - **渐进式加载**：当内容超过 200 行时，将详细数据拆分到 references/ 目录
+   - **Name 规范**：如 name 不符合 `^[a-z0-9]+(-[a-z0-9]+)*$` 格式，提示用户确认是否重命名
+
+### 第 4 步：重新评估
+
+修改完成后，再次调用 blame-skill 进行审计评分，回到第 2 步。
+
+## 迭代控制
+
+| 参数 | 值 | 说明 |
+|------|-----|------|
+| 目标分数 | 90 | A 级（优秀） |
+| 最大迭代次数 | 5 | 防止无限循环 |
+| 迭代计数起点 | 1 | 首次评估计为第 1 次 |
+
+## 输出格式
+
+迭代结束后，输出最终报告：
+
+```
+## Skill 优化报告：[skill-name]
+
+### 最终得分：XX / 100（等级：X）
+### 迭代次数：X / 5
+
+### 各轮得分变化
+
+| 轮次 | 得分 | 等级 | 主要改进项 |
+|------|------|------|-----------|
+| 1 | XX | X | 初始评估 |
+| 2 | XX | X | [改进项1], [改进项2] |
+| ... | ... | ... | ... |
+
+### 改进摘要
+
+- [改进项1]：[修改前] → [修改后]
+- [改进项2]：[修改前] → [修改后]
+
+### 未解决项（如有）
+
+- [ ] **[项目名]**：[原因说明]
+```
+
+## 一定要做
+
+1. 每次迭代前必须调用 blame-skill 获取最新评分
+2. 按改进优先级从高到低处理 issue
+3. 修改 SKILL.md 后立即重新评估
+4. 记录每轮迭代的得分变化
+5. 迭代结束时输出完整的优化报告
+
+## 一定不要做
+
+1. 不要跳过 blame-skill 评估直接修改
+2. 不要在一次迭代中修改后不重新评估就继续修改
+3. 不要修改 blame-skill 的评分规则
+4. 不要在未达到 90 分时提前终止（除非已达 5 次上限）
+5. 不要修改目标 Skill 的核心功能语义（只优化结构，不改意图）
+
+## 失败处理
+
+| 场景 | 处理方式 |
+|------|---------|
+| 目标 Skill 不存在 | 提示用户检查名称，终止流程 |
+| blame-skill 评估失败 | 终止流程，输出已完成的迭代结果 |
+| 5 次迭代仍未达标 | 输出当前最高分和未解决项，建议人工介入 |
+| 修改导致分数下降 | 回滚本次修改，跳过该项，继续下一优先级 |

package/skills/blame-skill/SKILL.md

@@ -0,0 +1,201 @@
+---
+name: blame-skill
+description: |
+  审计和评分 OpenCode Skill 定义文件（SKILL.md），基于工作流模式和最佳实践规则进行量化评估。
+  提供：评分规则（满分100分）、工作流匹配分析、改进建议生成。
+  适用：审查已有 Skill 质量、改进 Skill 定义、新建 Skill 前参考评分标准。
+  不适用：审查 Agent 定义、审查 Command 定义、通用代码审查。
+---
+
+# Skill 审计评分器
+
+## 工作流模式
+
+本 Skill 采用 **迭代优化** 工作流：
+1. **读取**：加载目标 SKILL.md 及 references/ 目录
+2. **评分**：按评分规则逐项打分
+3. **诊断**：列出未满足项及改进建议
+4. **输出**：生成结构化审计报告
+
+## 评分规则（满分 100 分）
+
+### 一、工作流匹配（20 分）
+
+Skill 是否符合某种明确的工作流模式，是评分的第一标准。
+
+| 项目 | 分值 | 评分标准 |
+|------|------|---------|
+| 工作流识别 | 8 分 | 能明确识别属于以下模式之一：顺序工作流、多 MCP 协调、迭代优化、上下文感知、领域智能。无法识别得 0 分 |
+| 工作流完整性 | 5 分 | 工作流步骤完整，有清晰的阶段划分或步骤编号。步骤模糊或不完整扣 3-5 分 |
+| 指令可执行 | 3 分 | 每个步骤的指令具体、可操作，非泛泛而谈。模糊指令扣 2-3 分 |
+| 失败处理 | 4 分 | 包含失败处理机制（回滚、重试、降级、人工介入）。无任何失败处理扣 4 分 |
+
+### 二、Description 质量（20 分）
+
+Description 是唯一决定 Skill 是否被触发的因素。
+
+| 项目 | 分值 | 评分标准 |
+|------|------|---------|
+| 具体能力 | 5 分 | 一句话说明核心能力，模糊不得分 |
+| 适用场景 | 5 分 | 明确列出触发场景，缺失扣 5 分 |
+| 不适用场景 | 5 分 | 明确列出边界限制，缺失扣 5 分 |
+| 提供资源 | 5 分 | 说明 Skill 包含的资源（表结构、公式、模板等），缺失扣 5 分 |
+
+### 三、Name 规范（10 分）
+
+| 项目 | 分值 | 评分标准 |
+|------|------|---------|
+| 命名规范 | 5 分 | 符合 `^[a-z0-9]+(-[a-z0-9]+)*$` 格式。不符合得 0 分 |
+| 语义清晰 | 5 分 | 名称反映核心功能，无法从名称推断用途扣 3-5 分 |
+
+### 四、正文质量（25 分）
+
+| 项目 | 分值 | 评分标准 |
+|------|------|---------|
+| Markdown 结构 | 5 分 | 使用标题、列表、表格等结构化格式。纯文本无结构扣 5 分 |
+| 具体示例 | 5 分 | 包含代码块或使用示例。无示例扣 5 分 |
+| 边界说明 | 5 分 | 明确说明不能做什么或限制条件。缺失扣 5 分 |
+| 输入输出规范 | 5 分 | 明确定义 Skill 的输入要求和输出格式。若 Skill 无需输入输出（如纯执行类），自动得 5 分；需要但缺失扣 5 分，定义不完整扣 2-3 分 |
+| 渐进式加载 | 5 分 | 主文件精简，详细数据放 references/。主文件过长（>200 行）且无 references 扣 5 分 |
+
+### 五、Frontmatter 规范（15 分）
+
+| 项目 | 分值 | 评分标准 |
+|------|------|---------|
+| name 字段 | 3 分 | 存在且与目录名一致。缺失或不一致扣 3 分 |
+| description 字段 | 5 分 | 存在且 1-1024 字符。缺失扣 5 分 |
+| description 长度 | 4 分 | 描述充分但不冗长（建议 50-300 字符）。过短（<30 字符）扣 2 分，过长（>500 字符）扣 2 分 |
+| 可选字段 | 3 分 | 合理使用 license / compatibility / metadata 等可选字段。无可选字段不扣分，有则检查合理性 |
+
+### 六、目录结构（10 分）
+
+| 项目 | 分值 | 评分标准 |
+|------|------|---------|
+| SKILL.md 存在 | 5 分 | 文件名必须为 SKILL.md（大写）。不存在得 0 分 |
+| references/ 使用 | 5 分 | 当内容较多时使用 references/ 目录存放详细文档。内容多但未拆分扣 5 分，内容少不需要则不扣分 |
+
+## 评分等级
+
+| 分数 | 等级 | 说明 |
+|------|------|------|
+| 90-100 | A 优秀 | 完全符合最佳实践 |
+| 75-89 | B 良好 | 基本符合，有少量改进空间 |
+| 60-74 | C 合格 | 可用但需要改进 |
+| 40-59 | D 不足 | 存在明显问题 |
+| <40 | E 较差 | 需要重写 |
+
+## 输入要求
+
+用户必须提供要审计的 **skill 名称**（如 `git-feat`、`clean-code`）。
+
+## Skill 加载路径
+
+按以下顺序查找目标 Skill 的 SKILL.md 文件，找到即停止：
+
+1. **项目级**：`.opencode/skills/<name>/SKILL.md`（从当前目录向上遍历至 git worktree）
+2. **OPENCODE_CONFIG_DIR**：`$OPENCODE_CONFIG_DIR/skills/<name>/SKILL.md`
+3. **全局**：`~/.config/opencode/skills/<name>/SKILL.md`
+
+如果目录下存在 `references/` 子目录，也一并读取用于评估渐进式加载。
+
+## 审计流程
+
+### 步骤 1：定位并读取目标 Skill
+
+根据用户提供的 skill 名称，按上述路径顺序查找 SKILL.md。未找到则提示用户检查名称或路径。
+
+### 步骤 2：逐项评分
+
+按上述六大类评分规则，逐项评估并记录得分和扣分原因。
+
+### 步骤 3：生成审计报告
+
+按以下格式输出：
+
+```
+## Skill 审计报告：[skill-name]
+
+### 总分：XX / 100（等级：X）
+
+### 分项得分
+
+| 类别 | 得分 | 满分 |
+|------|------|------|
+| 工作流匹配 | XX | 20 |
+| Description 质量 | XX | 20 |
+| Name 规范 | XX | 10 |
+| 正文质量 | XX | 25 |
+| Frontmatter 规范 | XX | 15 |
+| 目录结构 | XX | 10 |
+
+### 未满足项及改进建议
+
+- [ ] **[项目名]** (扣 X 分)
+  - 现状：[当前情况]
+  - 建议：[具体改进方案]
+
+### 改进优先级
+
+1. [最应优先改进的项]
+2. [次优先改进的项]
+3. ...
+```
+
+### 步骤 4：输出格式
+
+支持两种输出模式，根据调用方式自动选择：
+
+#### 模式 A：人类阅读模式（默认）
+
+用户直接调用 blame-skill 时使用，输出完整的 Markdown 审计报告。
+
+#### 模式 B：结构化模式（程序化调用）
+
+当调用参数包含 `--format=json` 或由其他 Skill 程序化调用时，输出 JSON 结构化结果，便于自动化解析：
+
+```json
+{
+  "skill_name": "git-clear",
+  "total_score": 76,
+  "grade": "B",
+  "scores": {
+    "workflow_match": 14,
+    "description_quality": 9,
+    "name_convention": 9,
+    "content_quality": 21,
+    "frontmatter": 13,
+    "directory_structure": 10
+  },
+  "score_details": {
+    "workflow_match": {
+      "workflow_identification": 8,
+      "workflow_completeness": 5,
+      "instruction_executable": 3,
+      "failure_handling": 0
+    },
+    "content_quality": {
+      "markdown_structure": 5,
+      "concrete_examples": 5,
+      "boundary_description": 5,
+      "input_output_spec": 0,
+      "progressive_loading": 5
+    }
+  },
+  "issues": [
+    {
+      "item": "工作流识别",
+      "deduction": 2,
+      "current": "工作流隐含在步骤中，未显式声明工作流模式",
+      "suggestion": "在正文开头明确声明工作流模式（如'本 Skill 采用顺序工作流'）"
+    }
+  ],
+  "improvement_priority": [
+    "Description 补充不适用场景和提供资源",
+    "Description 长度扩展"
+  ]
+}
+```
+
+### 步骤 5：如果用户需要，提供改进后的 SKILL.md
+
+根据审计结果，重写一份符合最佳实践的 SKILL.md 供用户参考。

package/skills/lint-ai-fix/SKILL.md

@@ -0,0 +1,141 @@
+---
+name: lint-ai-fix
+description: |
+  对 linter 无法自动修复的违规进行 AI 语义修复。内部管理 fix→验证→复检 的 loop（max 3），
+  每次修改后做语法验证，失败则 git checkout 回滚并记人工处理项。agent 只接收最终输出。
+  适用：lint agent 的 AI 修复阶段，处理 lint-tool-fix 的剩余违规。
+  不适用：linter --fix 可修复的违规（使用 lint-tool-fix）、规则检查（使用 lint-rules-analyze）。
+---
+
+# Lint AI 语义修复
+
+## 工作流模式
+
+内部迭代执行（max 3 轮），4 个阶段。
+
+## 输入
+
+| 参数 | 必填 | 类型 | 说明 |
+|------|------|------|------|
+| remaining_violations | 是 | array | lint-tool-fix 输出的剩余违规列表 |
+| target_dir | 是 | string | 检查目标目录路径 |
+| root_dir | 是 | string | 工程根目录路径 |
+| primary_language | 是 | string | 主语言（`jsts` 或 `python`） |
+| config_file_path | 是 | string | lint 配置文件路径 |
+
+## 输出
+
+- `ai_fixed_count`：AI 修复的违规数
+- `final_violations`：修复后剩余的违规列表（结构同输入）
+- `manual_items`：无法修复的人工处理项列表，每条含 `{ ...violation, fix_attempted, reason }`
+
+## 内部 Loop（max 3）
+
+```
+inner_round 1: 逐条修复 → 语法验证 → linter 复检
+inner_round 2: 逐条修复 → 语法验证 → linter 复检
+inner_round 3: 逐条修复 → 语法验证 → linter 复检
+
+退出条件:
+  - 0 违规 → 成功退出
+  - 无改进（违规数 >= 轮首） → 退出，输出 manual_items
+  - inner_round = 3 → 超限退出，输出 manual_items
+```
+
+## 阶段一：逐条分析修复
+
+对 `remaining_violations` 中的每条违规：
+
+1. 分析违规规则和上下文
+2. 修改源码文件以消除违规
+3. 记录修改的文件和修复内容
+
+### 修复策略
+
+| 规则类型 | 修复策略 |
+|---------|---------|
+| 未使用变量/import | 删除未使用的声明 |
+| 未定义变量 | 添加定义或修正引用 |
+| debugger 语句 | 删除 debugger |
+| 空语句块 | 添加注释或实现 |
+| 比较使用 None/True/False | 改为 is/is not |
+| 其他规则 | 按规则语义最小改动修复 |
+
+## 阶段二：语法验证
+
+每次修改文件后，执行语法验证：
+
+| 主语言 | 验证命令 |
+|--------|---------|
+| jsts | `node --check {file}` |
+| python | `python3 -m py_compile {file}` |
+
+| 条件 | 动作 |
+|------|------|
+| 语法验证通过 | 继续阶段三 |
+| 语法验证失败 | `git checkout {file}` 回滚，标记为 manual_item，跳过该文件 |
+
+## 阶段三：linter 复检
+
+对所有修改的文件重新执行 linter 检查（同 lint-rules-analyze 命令），获取当前违规数。
+
+## 阶段四：退出判断
+
+| 条件 | 动作 |
+|------|------|
+| 当前违规数 = 0 | 成功退出，输出 ai_fixed_count + 空 final_violations |
+| 当前违规数 >= 轮首违规数 | 无改进退出，输出 final_violations + manual_items |
+| inner_round = 3 | 超限退出，输出 final_violations + manual_items |
+| 否则 | inner_round++，回到阶段一 |
+
+## 输出格式
+
+```
+## AI 修复结果
+
+- AI 修复数: X
+- 最终违规数: X
+- 人工处理项: X
+
+### 修复记录
+| # | 文件 | 规则 | 修复内容 |
+|---|------|------|---------|
+| 1 | src/foo.js | no-unused-vars | 删除未使用变量 x |
+
+### 人工处理项
+| # | 文件 | 行号 | 规则 | 原因 |
+|---|------|------|------|------|
+| 1 | src/bar.js | 20 | no-console | 需确认是否保留 console.log |
+```
+
+## 决策
+
+| 条件 | 动作 |
+|------|------|
+| final_violations 为空 | agent 回到轮尾评分（final_count 应为 0 → 达标） |
+| final_violations 非空 | agent 回到轮尾评分（独立验证） |
+
+## 失败处理
+
+| 场景 | 处理方式 |
+|------|---------|
+| 源码修改后语法失败 | git checkout 回滚，记 manual_item |
+| linter 复检失败 | 使用上一次的违规列表作为 final_violations |
+| git checkout 失败 | 报错，保留当前状态，记 manual_item |
+| 文件只读 | 记 manual_item，跳过 |
+
+## 一定要做
+
+1. 每次修改后必须做语法验证
+2. 语法验证失败必须 git checkout 回滚
+3. 内部 loop 退出条件清晰（0 违规/无改进/超限）
+4. 输出 manual_items 含 fix_attempted 和 reason
+5. 修复是最小改动，不做重构
+
+## 一定不要做
+
+1. 不要做大规模重构
+2. 不要修改非违规文件的代码
+3. 不要跳过语法验证
+4. 不要在语法验证失败时不回滚
+5. 不要执行网络请求

package/skills/lint-config-setup/SKILL.md

@@ -0,0 +1,106 @@
+---
+name: lint-config-setup
+description: |
+  生成或补全 lint 配置文件。读取语言规则清单，按初始启用规则生成 eslint.config.js 或 ruff.toml。
+  已有配置文件时只追加缺失的启用规则，不覆盖用户自定义规则。
+  适用：lint agent 的配置生成阶段，在规则分析前确保配置文件存在且包含初始规则集。
+  不适用：非 lint 场景的配置生成、手动配置调优。
+---
+
+# Lint 配置生成
+
+## 工作流模式
+
+顺序执行，4 个阶段。
+
+## 输入
+
+| 参数 | 必填 | 类型 | 说明 |
+|------|------|------|------|
+| root_dir | 是 | string | 工程根目录路径 |
+| primary_language | 是 | string | 主语言（`jsts` 或 `python`） |
+
+## 输出
+
+- `config_file_path`：配置文件绝对路径
+- `enabled_rules`：已启用的规则列表
+- `total_rules`：规则清单中的全量规则数
+- `config_generated`：是否新建配置（true=新建，false=已有补全）
+
+## 阶段一：加载规则清单
+
+读取 `references/languages/{primary_language}.md`，解析规则清单表格：
+
+| 主语言 | 规则文件 | 配置文件名 |
+|--------|---------|-----------|
+| jsts | `references/languages/js.md` | `eslint.config.js` |
+| python | `references/languages/py.md` | `ruff.toml` |
+
+提取所有"初始启用"标记为 ✓ 的规则。
+
+## 阶段二：检查已有配置
+
+检查 `root_dir` 下是否已有配置文件：
+
+| 主语言 | 检查文件 |
+|--------|---------|
+| jsts | `eslint.config.js`、`.eslintrc.json`、`.eslintrc.js` |
+| python | `ruff.toml`、`pyproject.toml`（含 `[tool.ruff]` 段） |
+
+## 阶段三：生成或补全
+
+| 条件 | 动作 |
+|------|------|
+| 无配置文件 | 从模板生成新配置文件，写入初始启用规则，`config_generated = true` |
+| 有配置文件 | 读取已有规则，追加缺失的初始启用规则（不覆盖用户自定义），`config_generated = false` |
+
+### 生成模板
+
+jsts → `eslint.config.js`（flat config 格式）：
+```javascript
+import js from '@eslint/js';
+export default [
+  js.configs.recommended,
+  { rules: { /* 初始启用规则 */ } },
+];
+```
+
+python → `ruff.toml`：
+```toml
+[lint]
+select = ["F401", "F811", "F841", "E711"]
+```
+
+## 阶段四：输出
+
+输出配置文件路径、已启用规则列表、全量规则数、是否新建。
+
+## 决策
+
+| 条件 | 动作 |
+|------|------|
+| 生成/补全成功 | 输出结果，流程结束 |
+| 生成失败 | 报错，agent 退出 |
+| 规则清单文件缺失 | 报错"规则清单文件不存在"，agent 退出 |
+
+## 失败处理
+
+| 场景 | 处理方式 |
+|------|---------|
+| 规则清单文件不存在 | 报错退出 |
+| 配置文件写入失败 | 报错退出 |
+| 已有配置解析失败 | 报错退出，提示用户检查配置文件格式 |
+
+## 一定要做
+
+1. 从规则清单文件读取初始启用规则
+2. 已有配置只追加缺失规则，不覆盖用户自定义
+3. eslint.config.js 使用 flat config 格式（ESLint 9+）
+4. 输出 config_generated 标识新建 vs 补全
+
+## 一定不要做
+
+1. 不要覆盖用户已有的自定义规则
+2. 不要修改非配置文件
+3. 不要写入初始未启用的规则
+4. 不要执行网络请求

package/skills/lint-config-setup/references/languages/js.md

@@ -0,0 +1,110 @@
+# JS/TS ESLint 规则清单
+
+## 工具信息
+
+| 项 | 值 |
+|---|---|
+| 工具 | ESLint |
+| 安装 | `npm install -D eslint` |
+| TS 扩展 | `npm install -D @typescript-eslint/parser @typescript-eslint/eslint-plugin` |
+| 配置文件 | `eslint.config.js`（flat config，ESLint 9+） |
+| 检查命令 | `npx eslint {target_dir} --format json` |
+| 修复命令 | `npx eslint {target_dir} --fix` |
+| 输出格式 | JSON 数组，每元素含 `filePath` + `messages[]` |
+
+## ESLint JSON 输出解析
+
+```json
+[
+  {
+    "filePath": "/abs/path/to/file.js",
+    "messages": [
+      {
+        "ruleId": "no-unused-vars",
+        "severity": 2,
+        "message": "'x' is defined but never used",
+        "line": 10,
+        "column": 5,
+        "fix": { "range": [100, 110], "text": "" }
+      }
+    ]
+  }
+]
+```
+
+- `severity`: 1 = warning, 2 = error
+- `fix` 存在 = 可自动修复（`fixable = true`）
+
+## 规则清单
+
+> 初始启用标记 ✓ 的规则在配置生成时写入 config 文件；✗ 的规则仅记录在清单中，后续可逐步放开。
+
+### Possible Errors
+
+| 规则 | 描述 | 默认级别 | 初始启用 | 可 fix |
+|------|------|---------|---------|--------|
+| no-unused-vars | 禁止未使用的变量 | error | ✓ | ✗ |
+| no-undef | 禁止未定义的变量 | error | ✓ | ✗ |
+| no-cond-assign | 禁止条件表达式中赋值 | error | ✗ | ✓ |
+| no-debugger | 禁止 debugger 语句 | error | ✓ | ✗ |
+| no-dupe-keys | 禁止对象字面量重复键 | error | ✗ | ✓ |
+| no-dupe-args | 禁止函数参数重复 | error | ✗ | ✓ |
+| no-empty | 禁止空语句块 | error | ✓ | ✓ |
+| no-extra-semi | 禁止多余分号 | error | ✗ | ✓ |
+| no-irregular-whitespace | 禁止不规则的空白字符 | error | ✗ | ✗ |
+| no-unreachable | 禁止 return 后的不可达代码 | error | ✗ | ✓ |
+
+### Best Practices
+
+| 规则 | 描述 | 默认级别 | 初始启用 | 可 fix |
+|------|------|---------|---------|--------|
+| no-console | 禁止 console | warn | ✗ | ✓ |
+| no-constant-condition | 禁止常量条件表达式 | error | ✗ | ✗ |
+| no-dupe-else-if | 禁止重复的 else if | error | ✗ | ✓ |
+| no-empty-pattern | 禁止空解构模式 | error | ✗ | ✓ |
+| no-ex-assign | 禁止 catch 中重新赋值异常 | error | ✗ | ✓ |
+| no-fallthrough | 禁止 switch 穿透 | error | ✗ | ✗ |
+| no-redeclare | 禁止重复声明 | error | ✗ | ✓ |
+| no-useless-return | 禁止无用的 return | error | ✗ | ✓ |
+| eqeqeq | 要求严格相等 === | error | ✗ | ✓ |
+| prefer-const | 优先使用 const | error | ✗ | ✓ |
+
+### Stylistic Issues
+
+| 规则 | 描述 | 默认级别 | 初始启用 | 可 fix |
+|------|------|---------|---------|--------|
+| semi | 分号一致性 | warn | ✗ | ✓ |
+| quotes | 引号一致性 | warn | ✗ | ✓ |
+| indent | 缩进一致性 | warn | ✗ | ✓ |
+| no-trailing-spaces | 禁止行尾空格 | warn | ✗ | ✓ |
+| eol-last | 文件末尾换行 | warn | ✗ | ✓ |
+| no-multiple-empty-lines | 禁止多个空行 | warn | ✗ | ✓ |
+
+### ES6+
+
+| 规则 | 描述 | 默认级别 | 初始启用 | 可 fix |
+|------|------|---------|---------|--------|
+| no-const-assign | 禁止修改 const | error | ✗ | ✗ |
+| no-dupe-class-members | 禁止重复类成员 | error | ✗ | ✓ |
+| no-var | 禁止 var | error | ✗ | ✓ |
+| prefer-arrow-callback | 优先箭头函数回调 | warn | ✗ | ✓ |
+
+## 配置文件模板（eslint.config.js）
+
+```javascript
+import js from '@eslint/js';
+
+export default [
+  js.configs.recommended,
+  {
+    rules: {
+      'no-unused-vars': 'error',
+      'no-undef': 'error',
+      'no-debugger': 'error',
+      'no-empty': 'error',
+    },
+  },
+];
+```
+
+> 仅写入初始启用 ✓ 的规则。用户已有配置文件时只追加缺失规则，不覆盖。