用途:该技能在用户提出配置 Biome、扩展 biome 配置、搭建 BiomeJS、添加 biome overrides、biome lint-staged 等需求时使用,提供基于 Sablier 项目模式的 BiomeJS 配置快速指导。
主要能力:扩展共享配置(通过 npm 包导出,消费项目必须自行提供 files.includes);monorepo 中工作区配置用 "//" 继承根配置;文件包含模式(库、UI/前端、含 GraphQL 项目及排除项);常用 overrides(测试文件放宽规则、生成/ABI 文件关闭排序与紧凑格式化、导入限制强制 barrel 导入);关键规则参考(如 noFloatingPromises、noUnusedImports、useSortedKeys、useSortedClasses 等);Git 钩子与 lint-staged 集成;UI 项目 Tailwind CSS 配置。
使用方式:在 biome 配置中通过 extends 引用共享配置,并显式声明 files.includes;monorepo 子包用 "//" 继承;按需添加 overrides;lint-staged 中调用 bun biome check --write 等命令。示例配置与 lint-staged 文件见 ./examples/ 目录。
适用场景:需要统一 JS/TS/JSON/CSS 格式化与 lint 的库、前端、monorepo 项目,尤其是使用 Tailwind 的 UI 项目。
限制:Biome 处理 JS/TS/JSON/CSS 格式化,Markdown 与 YAML 需用 Prettier;Biome v2.4.0 起 HTML 格式化行为变化较大,HTML/Vue/Svelte/Astro 可能产生较大 diff;v2.4+ 的 check/ci 支持 --only 与 --skip,check --write 同时应用格式化,配置查找支持隐藏文件与用户配置目录;v2.4.0+ 对 *.module.css 自动启用 CSS Modules 解析。高级功能、迁移与完整规则参考需查阅官方 Biome 文档。