biome-validator について
biome-validatorは、JavaScriptおよびTypeScriptプロジェクトのBiome設定を構築・監査するスキルです。設定パターンや非推奨項目、CI/CDへの適合性を確認します。
主な機能
- 01Biome schemaとパッケージバージョンの検証
- 02linterとassist設定の確認
- 03フレームワークdomain設定の確認
- 04非推奨設定パターンの検出
- 05ESLintからの移行ガイド
活用シーン
- 01新しいBiome設定の確認
- 02既存のbiome.jsonの監査
- 03AI生成Biome設定の確認
- 04CI/CD前のBiome設定検証
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ shipshitdev/ skills --skill biome-validatorインストール後、Claude Code で/biome-validatorを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
plugin.jsonreferences/full-guide.mdscripts/validate.py詳細
Biome バリデーター
有効になるケース
- 新しいプロジェクトにリンティングを設定するとき
- コード品質に関する作業を始める前
- 既存の Biome 設定を監査するとき
- AI が biome.json を生成した後
- CI/CD パイプラインの検証
クイックスタート
python3 scripts/validate.py --root .
python3 scripts/validate.py --root . --strict
チェック対象
| チェック項目 | 正しい設定(2.3+) | 不適切な設定(旧式) |
|---|---|---|
| スキーマバージョン | "$schema": ".../2.3.12/schema.json" | .../1.9.0/schema.json またはそれ以前 |
| パッケージバージョン | "@biomejs/biome": "^2.3.0" | "^1.9.0" または 2.0~2.2 |
| リンター設定 | linter.rules.recommended: true | 欠落、または旧式の rules 形式 |
| アシストのアクション | assist.actions.source.organizeImports | トップレベルの organizeImports.enabled |
| ドメイン | linter.domains.react / .next: "on" | ドメインが未設定 |
| 抑制コメント | // biome-ignore lint/<rule>: reason | // eslint-disable、// @ts-ignore |
Biome 2.0+ では、型情報を使ったリンティング(TypeScript コンパイラー不要)と、複数ファイルにわたるリンティング分析も追加されています。
適切な設定と不適切な設定の例、および推奨される biome.json の完全版については、references/full-guide.md(§ チェック対象、§ Biome 2.3+ の機能、§ 推奨設定)をご覧ください。
非推奨のパターン
| 非推奨 | 置き換え(2.3+) |
|---|---|
organizeImports.enabled | assist.actions.source.organizeImports |
| スキーマ 2.0 未満 | スキーマ 2.3.11 以降 |
@biomejs/biome 2.3 未満 | @biomejs/biome@latest |
| ドメイン設定なし | フレームワークには linter.domains を使用 |
検証レポートの例については、references/full-guide.md(§ 検証結果)をご覧ください。
ESLint からの移行
- ESLint/Prettier のパッケージを削除し、
@biomejs/biome@latestを追加します - 設定を生成します:
bunx biome init - 既存のルールを移行します:
bunx biome migrate eslint --write package.jsonの lint/format スクリプトを更新し、biomeを呼び出すようにします- 古い
.eslintrc*/.prettierrc*/.eslintignore/.prettierignoreを削除します
各手順で使用する正確なコマンドに加え、VS Code のエディター設定と CI/CD ワークフローのスニペットについては、references/full-guide.md(§ ESLint からの移行)をご覧ください。
連携
linter-formatter-init- Biome を一からセットアップしますnextjs-validator- Next.js を検証します(next ドメインを有効にします)bun-validator- Bun ワークスペースを検証します
コメント
Markdown 対応