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 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/eslint-config-decent/raw/index.md(查看排版版本)