技能介绍

解决什么问题

当项目里反复出现某种坏味道——比如有人习惯把 var 声明随手堆在顶层，或者 console 语句散落在生产代码中——内置规则往往覆盖不到，你需要一条自定义 ESLint 规则。但手写规则并不轻松：要先用 AST Explorer 确认目标语法的节点结构，再编写 meta（含 schema 和 messages）、create 函数、可选的 fixer，最后用 RuleTester 补上正反用例。模板代码繁琐，测试最容易被省略，规则质量也参差不齐。

它如何工作

这个技能把上述流程压缩成一次自然语言输入：你描述要禁止或鼓励的行为，它基于 ESLint 的 RuleTester API 与 AST Explorer 的模式，生成完整的规则模块，包括：

meta 定义与 JSON Schema，声明可选项与报告消息；
create 函数，在对应 AST 节点上注册检查逻辑；
可用的 fixer，为可自动修复的问题生成替换逻辑；
一套覆盖面较全的 RuleTester 测试用例。

输出是可以直接放进项目的独立模块，而不是一段需要人补全的提示词。

适用边界与注意点

生成结果依赖目标代码的 AST 结构，在宏或实验性语法下需要人工核对节点类型。
fixer 会直接改写代码，合并前务必跑一遍测试，确认替换不破坏语义。
环境要求来自上游 ESLint：Node.js 需为 ^20.19.0、^22.13.0 或 >=24 且带 SSL 支持；Pnpm 场景需配置 node-linker=hoisted；若使用官方 TypeScript 类型定义，要求 TypeScript 5.3 或更高版本。
规则的语义最终由测试用例定义，生成的用例是起点，不是终点。