Security Scan

by affaan-mef648e01899bNo license275K starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated 3 days ago

AgentShield を使用して、Claude Code の設定（.claude/ ディレクトリ）のセキュリティ脆弱性、設定ミス、インジェクションリスクをスキャンします。CLAUDE.md、settings.json、MCP サーバー、フック、エージェント定義をチェックします。

Instructions onlySecurity
AI-generated overview

Audits Claude Code configuration for security vulnerabilities, misconfigurations and injection risks using AgentShield.

What it does
This skill instructs the agent to run the AgentShield CLI against a project's .claude/ directory to audit Claude Code configuration. It covers CLAUDE.md, settings.json, mcp.json, hooks and agent definitions, checking for hardcoded secrets, overly permissive allowlists, missing denylists, command injection via interpolation, data exfiltration and risky MCP servers. It can produce terminal, JSON, Markdown or HTML reports, apply safe automatic fixes, run a deeper adversarial analysis, and initialize a hardened configuration from scratch.
When to use it
Use it when setting up a new Claude Code project, after changing settings.json, CLAUDE.md or MCP configuration, before committing configuration changes, when onboarding a repository that already has Claude Code configuration, or for periodic security hygiene checks.
Requirements
Requires Node.js/npm and the AgentShield CLI (ecc-agentshield), installed globally or run via npx; the optional deep analysis mode needs an ANTHROPIC_API_KEY. No scripts ship with the skill; it provides instructions only.

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 がインストールされている必要があります。確認し、必要に応じてインストールします：

bash
# インストール済みか確認npx ecc-agentshield --version
# グローバルにインストール（推奨）npm install -g ecc-agentshield
# または npx 経由で直接実行（インストール不要）npx ecc-agentshield scan .

使用方法

基本スキャン

現在のプロジェクトの .claude/ ディレクトリに対して実行します：

bash
# 現在のプロジェクトをスキャンnpx ecc-agentshield scan
# 特定のパスをスキャンnpx ecc-agentshield scan --path /path/to/.claude
# 最小深刻度フィルタでスキャンnpx ecc-agentshield scan --min-severity medium

出力フォーマット

bash
# ターミナル出力（デフォルト） — グレード付きのカラーレポート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

自動修正

安全な修正を自動的に適用します（自動修正可能とマークされた修正のみ）：

bash
npx ecc-agentshield scan --fix

これにより以下が実行されます：

  • ハードコードされたシークレットを環境変数参照に置き換え
  • ワイルドカード権限をスコープ付き代替に厳格化
  • 手動のみの提案は変更しない

Opus 4.6 ディープ分析

より深い分析のために敵対的な3エージェントパイプラインを実行します：

bash
# ANTHROPIC_API_KEY が必要export ANTHROPIC_API_KEY=your-keynpx ecc-agentshield scan --opus --stream

これにより以下が実行されます：

  1. 攻撃者（レッドチーム） — 攻撃ベクトルを発見
  2. 防御者（ブルーチーム） — 強化を推奨
  3. 監査人（最終判定） — 両方の観点を統合

安全な設定の初期化

新しい安全な .claude/ 設定をゼロから構築します：

bash
npx ecc-agentshield init

作成されるもの：

  • スコープ付き権限と拒否リストを持つ settings.json
  • セキュリティベストプラクティスを含む CLAUDE.md
  • mcp.json プレースホルダー

GitHub Action

CI パイプラインに追加します：

yaml
- uses: affaan-m/agentshield@v1  with:    path: '.'    min-severity: 'medium'    fail-on-findings: true

深刻度レベル

グレードスコア意味
A90-100安全な設定
B75-89軽微な問題
C60-74注意が必要
D40-59重大なリスク
F0-39クリティカルな脆弱性

結果の解釈

クリティカルな発見（即座に修正）

  • 設定ファイル内のハードコードされた API キーまたはトークン
  • 許可リスト内の Bash(*)（無制限のシェルアクセス）
  • ${file} 補間によるフック内のコマンドインジェクション
  • シェルを実行する MCP サーバー

高い発見（本番前に修正）

  • CLAUDE.md 内の自動実行命令（プロンプトインジェクションベクトル）
  • 権限内の欠落した拒否リスト
  • 不要な Bash アクセスを持つエージェント

中程度の発見（推奨）

  • フック内のサイレントエラー抑制（2>/dev/null、|| true）
  • 欠落した PreToolUse セキュリティフック
  • MCP サーバー設定内の npx -y 自動インストール

情報の発見（認識）

  • MCP サーバーの欠落した説明
  • 正しくフラグ付けされた禁止命令（グッドプラクティス）

リンク

Source and attribution

Source:affaan-m/eccindocs/ja-JP/skills/security-scanat commitef648e0

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal

More from affaan-m/ecc

Vue Patterns

affaan-m

Reference guide for Vue 3 Composition API, component architecture, Pinia state, Vue Router, and Nuxt SSR patterns.

Software Development275Kupdated 3 days ago

Uncloud

affaan-m

Reference guide for managing Uncloud clusters with the uc CLI: deploying services, Caddy ingress, ports, scaling and logs.

DevOps & Cloud275Kupdated 3 days ago

Team Agent Orchestration

affaan-m

Coordinates multiple AI agents as a team using work items, Kanban states, branch isolation, and merge gates.

AI & Agents275Kupdated 3 days ago

Tasteforge Video

affaan-m

Use for file-driven multimodal image, video, and 3D-asset discovery; taste interviews; distill or apply workflows; style-pack validation; editable EDL/FCPXML export; provenance audits; and offline planning that must fail closed before provider generation.

Awaiting classification275Kupdated 3 days ago

Taste

affaan-m

Defines an angelcore / cloud-trance / hyperpop visual direction for music videos and short-form edits, with mood, editing grammar and a beat-mapped shot plan.

Design & Creative275Kupdated 3 days ago

Social Publisher

affaan-m

Schedules and publishes social media posts across 13 platforms through the SocialClaw workspace API.

Marketing & Sales275Kupdated 3 days ago

More in Security

Compliance Tracking

anthropics

Featured

Tracks compliance requirements, audit readiness, and evidence for frameworks such as SOC 2, ISO 27001, GDPR, HIPAA, and PCI DSS.

Security27Kupdated today

Dpop Adoption

google

Featured

Guides implementation of OAuth 2.0 DPoP (RFC 9449) sender-constrained refresh tokens for Google's OAuth platform.

Security21Kupdated today

Secops Triage

google

Featured

Guides SOC analysts through triaging Google SecOps security alerts, from investigation to closure or escalation.

Security21Kupdated today

Secops Investigate

google

Featured

Guides SOC analysts through deep security incident and entity investigations in Google SecOps using UDM queries and timelines.

Security21Kupdated today

Secops Hunt

google

Featured

Guides proactive threat hunting in Google SecOps using UDM queries, IoC lookback, prevalence and outlier analysis.

Security21Kupdated today

Secops Cases

google

Featured

Manages Google Security Operations SOAR cases across their lifecycle via MCP tools.

Security21Kupdated today