Agent Skills
返回列表
💻

ESLint 规则执行器

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3c6cb52e/eslint-rule-enforcer 到 AI 助手中。

技能介绍

解决了什么问题

在 monorepo 中维护 ESLint 规则时，开发者常面临几个实际痛点：

  • 规则配置分散在各子包中，难以统一执行与同步
  • 全量运行 lint 耗时较长，尤其在 CI 流水线中会拖慢反馈循环
  • 可自动修复的规则往往未被充分利用，需要人工判断哪些能安全修复

这个技能聚焦上述问题，将 ESLint v9 的 flat config 体系与 git 工作流结合。

核心能力与工作方式

技能基于 eslint-plugin-unicorn 和 @typescript-eslint/parser 提供规则集，核心流程如下：

  • 通过 git diff 扫描本次变更涉及的文件，而非全量遍历
  • 对变更文件应用 ESLint flat config 执行规则检查
  • 自动应用可修复的规则（auto-fixable rules）
  • 按 package 维度生成违规报告，包含不同严重级别的明细统计

关键在于，它不是简单地运行 lint 命令，而是利用 git diff 缩小检查范围，在 CI 场景中可显著减少 lint 时间。

适用边界与注意事项

  • 需要 Node.js ^20.19.0、^22.13.0 或 >=24 版本，且编译时启用了 SSL 支持
  • 使用 TypeScript 类型定义时要求 TypeScript >= 5.3
  • 配置 node-linker=hoisted 可避免依赖提升问题，但不适用于所有项目结构
  • 技能侧重自动化执行与报告生成，不负责规则策略的定义，团队仍需自行维护 eslint.config.js 规则集合

使用场景

  • CI 流水线需对仓库中本次改动的代码文件执行 ESLint v9 检查，避免全量扫描拖慢反馈节奏
  • 手动修复本地改动文件的 ESLint 告警，需要按子包区分违规严重度以同步各包规则
  • 线上环境出现紧急的 ESLint 规则违规问题，需要针对本次变更文件快速执行自动修复并验证结果
  • 团队评估新引入的 ESLint 规则对现有代码的影响范围，需要按包生成违规统计以判断修复成本

适合人员

  • Monorepo 后端开发者：想在 CI 中只检查本次改动文件，快速获取 lint 结果反馈
  • 前端工程化开发者：需要统一各子包的 ESLint 规则执行，减少人工同步成本
  • 运维工程师：遇到线上代码的 ESLint 违规告警，需快速定位变更文件并自动修复
  • 技术负责人：评估引入新 ESLint 规则后对现有代码的影响范围与修复可行性