ESLint 自定义规则构建器

解决什么问题

当团队代码规范超出 ESLint 内置规则的覆盖范围时，你迟早要写自定义规则。难点不在于「能不能写」，而在于规则落地质量难以保证：AST 匹配写歪了、context.report() 的 message 与文档对不上、自动修复逻辑只覆盖部分场景，这些缺陷往往在规则合并后才暴露。这个技能把规则开发的外围工作收敛掉，让你专注于规则本身的判定逻辑。

核心能力

• 脚手架生成：按 RuleTester API 的标准结构搭建规则骨架，规则文件的导出格式、meta 字段、create 函数的组织方式直接可用。
• 测试同步编写：基于 RuleTester 生成覆盖正常路径与错误路径的测试用例，验证 context.report() 触发的时机和参数是否符合预期。
• AST Explorer 模式适配：遵循 AST Explorer 的节点探索习惯，方便你在开发中快速定位目标语法节点、确认 node.type 与选择器写法。
• 文档与 autofix 配套：生成规则说明文档，并为可修复的规则补上 fixable 标记及自动修复实现，保证 --fix 行为与文档描述一致。

关键步骤

1. 明确规则要拦截或修复的代码模式，用 AST Explorer 确认目标节点类型。
2. 通过技能生成规则骨架与 RuleTester 测试脚手架。
3. 在 create 函数中实现节点监听与 context.report() 调用，同步补齐测试断言。
4. 若规则可自动修复，在 report 中附加 fix 逻辑，并在 meta.docs 中标注 fixable。
5. 校验测试全部通过后，将规则接入项目的 ESLint 配置。

适用边界

• 运行环境需要 Node.js ^20.19.0、^22.13.0 或 >=24，且编译时启用了 SSL 支持；官方发行版默认包含。
• 使用 ESLint 的 TypeScript 类型定义时，要求 TypeScript 5.3 及以上。
• 技能负责规则的结构与测试框架，不替代你对 ESLint 规则 API 本身的理解；复杂 AST 场景仍需结合官方文档调整选择器与遍历逻辑。