用途:当工作涉及 Oxlint 或 Oxc 检查时使用本技能,涵盖安装与配置、日常使用、规则与插件、React Compiler 检查规则、类型感知检查、与 ESLint 共存或迁移、编辑器与 CI 集成。
主要能力与工作流:先检查本地 Oxlint 现状,包括 oxlint、可选的 oxlint-tsgolint、eslint-plugin-oxlint、@oxlint/migrate 的包版本,配置形态,遗留 ESLint 设置、忽略文件、lint 脚本与编辑器 Oxc 设置,以及是否启用类型感知、JS 插件或 React Compiler 规则。搭建、渐进式采用、诊断循环、基线与排错优先参考 usage-guide.md;版本与快照不一致或涉及类型感知、JS 插件、React Compiler、迁移时,从 source-map.md 刷新官方文档。详细内容分流到 setup-cli-config.md(安装、CLI、配置结构、嵌套配置、忽略)、rules-plugins-typeaware.md(分类、插件、React Compiler、JS 插件、规则、行内忽略、类型感知)、eslint-ci-editors.md(ESLint 共存、迁移、编辑器、CI)。除用户要求迁移或扩大覆盖外,保留仓库既有 lint 严重级别与插件选择,并用最窄的有效命令验证。
关键判断:默认只启用 correctness 分类,其余分类与插件需显式开启;设置 plugins 会替换默认插件集。新配置优先 oxlint.config.ts 加 defineConfig。嵌套配置不自动与父级合并,需用 extends;-c/--config 会禁用嵌套查找。类型感知需 oxlint-tsgolint 与 --type-aware,且为根级选项。JS 插件为 alpha,React Compiler 规则为实验性。Vue/Svelte/Astro/Angular 仅覆盖脚本块而非模板。Oxlint 不是格式化工具。
验证:优先仓库自有命令,如 bunx oxlint、bunx oxlint --fix、bunx oxlint --type-aware,以及配合 --deny-warnings 或 --max-warnings 的 CI 式运行;ESLint 共存变更后同时运行 oxlint 与 eslint,并报告实际执行的检查与遗留假设。