SuperAPI AI 工具集

dotnet-biome

编程与开发

查看项目

更新于 10-16 00:05

技能介绍

用途:在同时包含 Node 前端资产的 .NET 仓库中引入或整理 Biome,用一套工具完成 JavaScript、TypeScript、CSS、JSON、GraphQL、HTML 的格式化、检查与导入排序,并明确它与 ESLint、Prettier、Stylelint 的职责边界。

触发条件:仓库已有 biome.json 或 @biomejs/biome;用户希望更快的格式化加检查一体化方案;需要统一格式化、检查与导入整理;或团队在比较 Biome 与 ESLint 加 Prettier、希望简化现有工具链。

不适用:依赖 Biome 尚未覆盖的 ESLint 插件或框架专用规则的仓库;运行时站点审计(响应头、无障碍、SEO)应交给 dotnet-webhint;CSS 或 HTML 仍由专用工具负责且未要求迁移的情况。

主要能力与用法:先确定归属模式(Biome 作为主要格式化与检查工具、仅用于格式化、或与 ESLint 共存以补插件缺口)。优先使用仓库内固定版本安装,保证 CI 与开发机一致。确认归属后再生成 biome.json。在 package.json 中加入可重复脚本,例如 biome check . 与 biome check . --write。迁移时先用 check 和限定目录,再全仓库启用 --write;大范围格式化或修复后重新运行前端构建与测试。

缺失时的引导:用 rg --files -g 'package.json' -g 'biome.json*' 与 rg -n '"@biomejs/biome"|"eslint"|"prettier"|"stylelint"' --glob 'package.json' . 检测现状;用 npm i -D -E @biomejs/biome 安装固定版本;用 npx @biomejs/biome init 创建配置;再用 npx @biomejs/biome check . 与 npx @biomejs/biome check . --write 验证。

限制与失败处理:与专用 ESLint 插件的规则差距属于归属问题,应保留 ESLint 处理相关文件;过宽的 --write 会造成大量改动,应从限定目录或变更文件开始;生成资产与第三方代码需在 biome.json 中排除;若 Biome 与 ESLint 结论冲突,应定义文件归属而非同时广泛运行。

交付与验证:明确 Biome 归属与版本固定、提交配置与可重复检查命令、相对 ESLint 的迁移或共存方案;验证归属模型有文档、CI 与本地版本一致、目标 glob 排除生成与第三方资产、--write 后下游构建或测试仍通过。结果状态可为 complete、clean、improved、configured、not_applicable 或 blocked。