eslint-config-decent

为TypeScript项目提供基于oxlint的代码规范配置

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:eslint-config-decent。
它的用途是:为TypeScript项目提供基于oxlint的代码规范配置
完整的 Skill 内容见:https://321skill.com/skills/eslint-config-decent/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“请帮我检查这个TypeScript组件文件的代码规范问题。”,AI可以调用配置了oxlint-config-decent的检查工具,快速扫描代码,不仅报告常见的语法和风格错误,还会根据项目启用的React、测试等规则,给出更贴近项目上下文的规范建议。或者说:“我们项目要迁移到oxlint,如何保持现有的代码检查规则?”,AI可以引导你安装和配置此包,并解释如何通过功能标志来匹配原有ESLint的检查范围。

介绍

这是一个专为TypeScript项目设计的oxlint配置包,旨在替代传统的ESLint配置。它解决了在追求更快的lint速度(oxlint)的同时,仍希望保持与成熟ESLint生态(如TypeScript、React、测试库等插件)高度兼容性的问题。

使用时,通过npm安装本包及oxlint等依赖,然后在oxlint.config.ts中导入并扩展此配置。它支持通过功能标志(如enableReact, enableVitest)按需启用对React、Vitest、Testing Library等生态的支持,并提供了处理Next.js项目等高级选项。

该配置非常适合那些希望从ESLint迁移到性能更优的oxlint,但又担心规则覆盖不全或现有项目配置迁移成本过高的前端、全栈及Node.js后端开发者。它尤其适合在CI/CD流程中需要快速反馈的中大型TypeScript项目。

需要注意的是,这是原eslint-config-decent的继任者,v5版本已完全转向oxlint。使用前需确保oxlint版本>=1.53.0以支持TypeScript配置。对于Vite+项目,配置方式略有不同,需直接集成到vite.config.ts的lint部分。

核心特点

本配置在原生oxlint规则基础上,通过兼容性插件和独立JS插件,实现了对原ESLint规则集约95%的覆盖率,在享受oxlint极速性能的同时,最大程度保留了熟悉的ESLint规则生态。它内置了处理相对导入文件扩展名和目录索引文件的专属规则,并提供了精细的功能开关来管理可选的插件依赖。

注意事项

不适合仅使用JavaScript或不使用TypeScript的项目,也不适合希望完全脱离ESLint生态、仅使用oxlint原生规则的场景。

常见问题

这个配置和原来的eslint-config-decent有什么区别?

这是原包的继任者,v5版本完全基于oxlint,放弃了ESLint配置,旨在提供更快的lint速度,同时通过插件保持高规则覆盖率。

支持React/Next.js/Vitest吗?

支持,可通过enableReact、enableNextJs、enableVitest等选项按需开启,它们是可选依赖,需额外安装对应插件。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/eslint-config-decent/raw/index.md 读取 eslint-config-decent 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。