Secret / Credential Scan 機密情報の混入検出

Pattern declaration

Primary pattern: Reviewer Secondary patterns: Inversion Why: 機密情報の検出はパターン的・決定論で判定できる領域が大きく、本来は CI に委ねるべき。一方で CI 未整備のリポジトリや、CI が見ない種別（個人パス・ローカル設定）を補足する補助レビューとして機能する。秘匿情報を含む追加が無ければ実行を止めるゲートが必要。

Goal / 目的

• 差分へ新規追加された機密情報を、言語やファイル種別を問わず検出する。対象は API キー / トークン / credential / 秘密鍵 / .env 値 / 個人ローカルパス / ローカル固有設定とする。
• 既存の言語限定 secret チェック（security-basic は .ts/.tsx/.js/.jsx、config-json は .json/.yml）が見ない種別・ファイルの取りこぼしを補う。

Non-goals / 扱わないこと

• アプリコード内の SQLi / XSS など機密以外のセキュリティ（security-basic の領域）。
• BaaS のルール/鍵露出（firebase-security-rules / supabase-rls-policy の領域）。
• 決定論で完全な判定ができる検出を恒久的な肩代わりとすること（本スキルは CI = gitleaks / trufflehog 等の導入を促し、移譲する）。

Pre-execution Gate / 実行前ゲート

このスキルは以下の条件がすべて満たされない限り NO_REVIEW を返す。

• 差分の追加行に、機密情報の候補（高エントロピー文字列・API_KEY/SECRET/TOKEN 等のキー・-----BEGIN ... PRIVATE KEY-----・/Users/ や /home/、C:\Users\ で始まる個人パス・.env 実値行）が含まれている
• inputContext に diff が含まれ、code_search（grep）が利用可能である

ゲート不成立時の出力: NO_REVIEW: secret-credential-scan — 機密情報の候補が差分に検出されない

False-positive guards / 抑制条件

• プレースホルダ・例値（xxx / your-api-key / dummy / example / <...> / ***）は指摘しない。
• .env.example / .env.sample / .env.template などサンプルファイルのプレースホルダは指摘しない（実値が入っていれば指摘する）。
• テストフィクスチャ・ドキュメントの明らかな擬似値は指摘しない。実在しうる形式（本物の鍵長・接頭辞 sk- / ghp_ / AKIA 等）の場合のみ指摘する。
• 既に環境変数参照（process.env.X / os.environ[...]）に置き換わっている場合は指摘しない。
• 既存行（差分の文脈行）にあるだけで追加・変更されていない機密は対象外（追加・変更行のみ）。

Rule / ルール

検出ロジック

1. 候補抽出: 差分の追加行から次の機密候補を抽出する。
   • 鍵名（API_KEY/SECRET/TOKEN/PASSWORD/CREDENTIAL）への実値代入
   • 既知接頭辞（sk-/ghp_/AKIA/AIza 等）や -----BEGIN ... PRIVATE KEY-----
   • 高エントロピー文字列、個人パス（/Users/<name>/、/home/<name>/、C:\Users\<name>\）、実値入り .env 行
2. 実値判定: プレースホルダ・例値・環境変数参照を code_search で確認して除外し、実在しうる値のみ残す。
3. 報告: 該当箇所を <file>:<line> で示し、機密の種別と推奨対応（環境変数 / Secrets への移動、コミット履歴からの除去、CI secret-scan の導入）を述べる。値そのものは出力に再掲しない（マスクする）。

制約

• 検出は最大 5 件。実害の大きいもの（本物の鍵・credential）を優先する。
• 各指摘に「種別」「混入箇所」「推奨対応」を必ず含める。
• 機密の値そのものは出力へ再掲せず、種別と位置のみ示す。
• 決定論で完全に検出できる範囲は「CI（gitleaks 等）での恒久ガードを推奨」と必ず併記する。

Evidence / 根拠の取り方

• 混入箇所は必ず <file>:<line> に紐づけ、推測で「秘密だ」と断定しない。
• プレースホルダか実値かの判定根拠（接頭辞・鍵長・形式）を具体的に示す。

Output / 出力フォーマット

すべて日本語。

(secret-scan):1: [要約] 最も重大な機密混入は〈1文〉

<file>:<line>: [機密混入1] <タイトル>
  種別: <API キー / トークン / 秘密鍵 / credential / 個人パス / .env 実値>
  混入: <どこに何が追加されたか（値はマスク）>(<file>:<line>)
  影響: <漏洩リスク / 権限奪取 / 環境依存の壊れ>
  Fix: <環境変数・Secrets への移動／履歴からの除去／CI secret-scan(gitleaks 等) の導入>

評価指標（Evaluation）

• 合格基準: 実在しうる機密のみを <file>:<line> で示し、プレースホルダ・例値・環境変数参照を誤検出していない。値を再掲していない。
• 不合格基準: プレースホルダへの誤検出、既存行への指摘、値の再掲、機密と無関係な高エントロピー文字列（ハッシュ・UUID）への難癖。

人間に返す条件（Human Handoff）

• 検出値が実在の機密と擬似値のどちらなのか、コードからは断定できない場合。
• 既にコミット済みの機密について、履歴除去・鍵ローテーションの要否が運用判断を要する場合。