Security Scan Skill
AgentShield を使用して、Claude Code の設定に関するセキュリティ問題を監査します。
アクティベートするタイミング
- 新しい Claude Code プロジェクトをセットアップするとき
.claude/settings.json、CLAUDE.md、または MCP 設定を変更した後- 設定の変更をコミットする前
- 既存の Claude Code 設定が含まれる新しいリポジトリにオンボーディングするとき
- 定期的なセキュリティ衛生チェック
スキャン対象
| ファイル | チェック内容 |
|---|---|
CLAUDE.md | ハードコードされたシークレット、自動実行命令、プロンプトインジェクションパターン |
settings.json | 過度に寛容な許可リスト、拒否リストの欠落、危険なバイパスフラグ |
mcp.json | リスクのある MCP サーバー、ハードコードされた環境シークレット、npx サプライチェーンリスク |
hooks/ | 変数展開によるコマンドインジェクション、データ流出、サイレントなエラー抑制 |
agents/*.md | 無制限のツールアクセス、プロンプトインジェクションの表面、モデル仕様の欠落 |
前提条件
AgentShield がインストールされている必要があります。必要に応じて確認し、インストールしてください:
# インストールされているか確認
npx ecc-agentshield --version
# グローバルにインストール（推奨）
npm install -g ecc-agentshield
# または npx で直接実行（インストール不要）
npx ecc-agentshield scan .
使用方法
基本スキャン
現在のプロジェクトの .claude/ ディレクトリに対して実行:
# 現在のプロジェクトをスキャン
npx ecc-agentshield scan
# 特定のパスをスキャン
npx ecc-agentshield scan --path /path/to/.claude
# 最小重大度フィルターを指定してスキャン
npx ecc-agentshield scan --min-severity medium
出力形式
# ターミナル出力（デフォルト）— 色付きレポートとグレード
npx ecc-agentshield scan
# JSON — CI/CD 統合用
npx ecc-agentshield scan --format json
# Markdown — ドキュメント用
npx ecc-agentshield scan --format markdown
# HTML — 自己完結型のダークテーマレポート
npx ecc-agentshield scan --format html > security-report.html
自動修正
安全な修正を自動的に適用します（自動修正可能とマークされた修正のみ）:
npx ecc-agentshield scan --fix
これにより:
- ハードコードされたシークレットを環境変数参照に置き換え
- ワイルドカードパーミッションをスコープ付きの代替に厳格化
- 手動のみの提案は決して変更しません
Opus 4.6 深層分析
3 エージェントパイプラインによる高度な分析を実行:
# ANTHROPIC_API_KEY が必要
export ANTHROPIC_API_KEY=your-key
npx ecc-agentshield scan --opus --stream
これにより:
- 攻撃者（レッドチーム） — 攻撃ベクトルを発見
- 防御者（ブルーチーム） — 堅牢化を提案
- 監査者（最終判定） — 両方の視点を統合
セキュア設定の初期化
新しいセキュアな .claude/ 設定をゼロからスキャフォールド:
npx ecc-agentshield init
作成されるもの:
- スコープ付きパーミッションと拒否リストを含む
settings.json - セキュリティベストプラクティスを含む
CLAUDE.md mcp.jsonプレースホルダー
GitHub Action
CI パイプラインに追加:
- uses: affaan-m/agentshield@v1
with:
path: '.'
min-severity: 'medium'
fail-on-findings: true
重大度レベル
| グレード | スコア | 意味 |
|---|---|---|
| A | 90-100 | セキュアな設定 |
| B | 75-89 | 軽微な問題 |
| C | 60-74 | 注意が必要 |
| D | 40-59 | 重大なリスク |
| F | 0-39 | クリティカルな脆弱性 |
結果の解釈
Critical（クリティカル） — 直ちに修正
- 設定ファイル内のハードコードされた API キーやトークン
- 許可リスト内の
Bash(*)（無制限のシェルアクセス） ${file}変数展開によるフックでのコマンドインジェクション- シェルを実行する MCP サーバー
High（高） — 本番環境前に修正
- CLAUDE.md 内の自動実行命令（プロンプトインジェクションベクトル）
- パーミッションの拒否リスト欠落
- 不要な Bash アクセスを持つエージェント
Medium（中） — 推奨
- フックでのサイレントエラー抑制（
2>/dev/null、|| true） - PreToolUse セキュリティフックの欠落
- MCP サーバー設定での
npx -y自動インストール
Info（情報） — 認識用
- MCP サーバーの説明欠落
- 禁止的な指示が正しく良い習慣としてフラグ付けされている