| name | biome-check |
| description | Run Biome lint/format check on modified TypeScript and JavaScript files and fix violations. Use after editing *.ts, *.tsx, *.js, *.jsx, *.mjs files and before reporting task completion or recommending git commit. Triggered by "/biome-check", "biome check", "lint check", or proactively as part of post-edit verification. |
Biome Check
プロジェクト規約 (biome.json + .claude/rules/linting.md) に従って lint / format 違反を検出・修正する。
When to use
- コード編集を伴うタスクの完了報告前
git commit を提案する前- ユーザーが
/biome-check を実行したとき
Skip when
- 編集が非コードファイル (
.md, .json, .yml, .toml, .css) のみ。ただし biome.json を編集した場合は npx biome check biome.json を実行する
- 既に直前で同じファイル群を check 済み
Steps
1. 対象ファイル特定
優先順位:
- 当該タスクで編集 / 作成したファイル
git status --short の M / A / ?? から *.{ts,tsx,js,jsx,mjs} を抽出_article/**, dist/**, styled-system/**, node_modules/**, .next/** は除外する。_article は files.includes、dist / styled-system / node_modules / .next は .gitignore + VCS 統合で除外される
2. Read-only check
npx biome check <files...>
編集対象ファイルを明示して biome を直接呼ぶ。npm run lint は src build tools tests を対象にするが、対象ファイルを限定できない。
3. 違反対応
自動修正を即時適用しない。ルールを理解してから対応する:
- 違反の rule id (例:
lint/performance/useTopLevelRegex) を確認
.claude/rules/linting.md でプロジェクト固有の意図を確認 (recommended からの override や厳格化の理由)- 必要に応じて
biome.json の該当 rule 設定を読む
- 修正方針:
- 意図的な逸脱でない限り、コード側を修正する (rule を抑制しない)
- 安全な auto-fix のみ適用したい場合は
npx biome check --write <files>
--write は safe fix のみ自動適用される。構造変更を伴う fix (例: useTopLevelRegex の定数化、useExportType の import type への書き換え) は 手動修正が必要
--unsafe は使わない (semantics が変わる可能性)- rule 抑制 (
biome-ignore) を検討する場合は .claude/rules/linting.md の該当節を参照する。原則は「局所的な正当化」または「SDK 慣用パターン」のみ
4. 再 check
npx biome check <files...> を再実行し 0 errors を確認。warnings は方針に応じて対応 (プロジェクトでは warn は記録のみで blocking しない例が多い)。
5. 報告
- 成功時: 1 行で完了 (例: "biome check 0 violations")
- 修正不能 / 意図的な保留: 理由を明示 (rule id, トレードオフ)
プロジェクト固有の注意
厳格化ルールの一覧と理由は .claude/rules/linting.md を参照する。
useTopLevelRegex は spec ファイルでも適用される。テスト内で expect(x).toMatch(/.../) のような inline regex はトップレベル定数に切り出す。
周辺ツールとの関係
| 仕組み | 検出タイミング | スコープ |
|---|
| 本 Skill | コード編集後、commit 前 | 編集対象ファイル全て |
nano-staged (pre-commit) | git commit 直前 | staged な **/*.{ts,tsx,js,mjs} |
npm run lint (CI / pr-validation.yml) | PR open / sync | src build tools tests |
本 Skill は CI / pre-commit のすり抜け (特に tests/ 配下) を AI セッション中に防ぐのが目的。
