陌讯skills聚合平台

scope-guard

📁 yusuketsunoda/ppt-trans 📅 Today
0
总安装量
1
周安装量
安装命令
npx skills add https://github.com/yusuketsunoda/ppt-trans --skill scope-guard

Agent 安装分布

amp 1
cline 1
opencode 1
cursor 1
continue 1
kimi-cli 1

Skill 文档

Scope Guard

コミット前に「意図しない差分」を検出し、ブランチ目的とのズレを警告するスキル。 混入差分の破棄コマンドまで提示する。

トリガー

  • ユーザーが /scope-guard を実行
  • “スコープチェック”, “差分チェック”, “混入チェック” に言及
  • /smart-commit の前段として組み込み可能

実行手順

1. ブランチ目的の推定

# ブランチ名からカテゴリを推定
git branch --show-current
ブランチプレフィックス 期待カテゴリ
feat/* src（機能コード）、tests
fix/* src（修正箇所）、tests
chore/* config、docs、scripts
refactor/* src（構造変更）、tests
docs/* docs、.claude/
test/* tests、e2e

2. 差分のカテゴリ分類

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処理

3. スコープ判定

ブランチの期待カテゴリと実際の差分カテゴリを比較:

判定 条件 アクション
IN_SCOPE 期待カテゴリと一致 問題なし
RELATED 期待カテゴリに付随（例: feat + tests） 許容
OUT_OF_SCOPE 期待カテゴリと無関係 警告 + 破棄コマンド提示

4. レポート出力

## Scope Guard Report

**ブランチ**: `fix/remove-isAdminEmail-reference`
**期待カテゴリ**: src, tests

### IN_SCOPE (2件)
- `src/app/actions/upload/security-checks.ts` → src
- `tests/lib/security/api-security-bypass.test.ts` → tests

### OUT_OF_SCOPE (2件) ⚠️
- `.nvmrc` → runtime (Node.jsバージョン変更)
- `package.json` → runtime (engines変更)

### 推奨アクション
```bash
# 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` の目視チェックだけでは見逃しやすい
- カテゴリ分類で機械的に検出し、判断コストを削減する
GitHub 仓库 ↗ ← 返回陌讯 Skills 聚合平台
本页面由 陌讯 Skills 聚合平台 收录整理，数据定期更新。