Scope Guard
コミット前に「意図しない差分」を検出し、ブランチ目的とのズレを警告するスキル。 混入差分の破棄コマンドまで提示する。
トリガー
-
ユーザーが /scope-guard を実行
-
"スコープチェック", "差分チェック", "混入チェック" に言及
-
/smart-commit の前段として組み込み可能
実行手順
- ブランチ目的の推定
ブランチ名からカテゴリを推定
git branch --show-current
ブランチプレフィックス 期待カテゴリ
feat/*
src（機能コード）、tests
fix/*
src（修正箇所）、tests
chore/*
config、docs、scripts
refactor/*
src（構造変更）、tests
docs/*
docs、.claude/
test/*
tests、e2e
- 差分のカテゴリ分類
git diff --name-only | while read f; do echo "$f"; done
各ファイルを以下のカテゴリに分類:
カテゴリ パターン 例
runtime .nvmrc , .node-version , engines in package.json Node.jsバージョン
deps package.json (dependencies), package-lock.json
依存関係
config .config. , tsconfig.json , .eslintrc
設定ファイル
infra .github/ , infrastructure/ , Dockerfile
インフラ
docs *.md , docs/ , .claude/ , messages/
ドキュメント
src src//*.ts , src//*.tsx
アプリケーションコード
tests tests/** , e2e/**
テスト
python python_backend/** , *.py
Python処理
- スコープ判定
ブランチの期待カテゴリと実際の差分カテゴリを比較:
判定 条件 アクション
IN_SCOPE 期待カテゴリと一致 問題なし
RELATED 期待カテゴリに付随（例: feat + tests） 許容
OUT_OF_SCOPE 期待カテゴリと無関係 警告 + 破棄コマンド提示
- レポート出力
Scope Guard Report
ブランチ: fix/remove-isAdminEmail-reference
期待カテゴリ: src, tests
IN_SCOPE (2件)
src/app/actions/upload/security-checks.ts→ srctests/lib/security/api-security-bypass.test.ts→ tests
OUT_OF_SCOPE (2件) ⚠️
.nvmrc→ runtime (Node.jsバージョン変更)package.json→ runtime (engines変更)
推奨アクション
# OUT_OF_SCOPE ファイルを破棄
git restore .nvmrc package.json
### 5. 対話モード
OUT_OF_SCOPE が検出された場合:
1. 各ファイルの差分を簡潔に表示
2. 「破棄」「コミットに含める」「別ブランチに退避」の選択肢を提示
3. ユーザーの判断で実行
## smart-commit との連携
`/smart-commit` のステップ0（docs-sync前）に `/scope-guard` を組み込み可能:
/scope-guard → /docs-sync → /smart-commit
## AI Assistant Instructions
このスキルが有効化された時:
1. **ブランチ名取得**: `git branch --show-current` でカテゴリを推定
2. **差分取得**: `git diff --name-only` で変更ファイル一覧を取得
3. **カテゴリ分類**: 各ファイルを runtime/deps/config/infra/docs/src/tests/python に分類
4. **スコープ判定**: ブランチの期待カテゴリと比較し IN_SCOPE / RELATED / OUT_OF_SCOPE を判定
5. **レポート出力**: OUT_OF_SCOPE がある場合は破棄コマンドを提示
6. **ユーザー判断**: 「破棄」「コミットに含める」「別ブランチに退避」の選択肢を提示
Always:
- OUT_OF_SCOPE ファイルの差分を簡潔に表示する（変更内容を見ないと判断できない）
- 破棄コマンドは `git restore <file>` 形式で提示する
- RELATED（tests等）は許容として扱い、警告しない
Never:
- ユーザー確認なしでファイルを破棄しない
- ステージ済み変更を勝手にリセットしない
## 教訓
- Node 22→24 が `.nvmrc`/`package.json` に無関係に混入した事故（2026-02-22）
- `git status --short` の目視チェックだけでは見逃しやすい
- カテゴリ分類で機械的に検出し、判断コストを削減する