Files
ECC/docs/ja-JP/commands/security-scan.md
T
Affaan MustafaandGitHub c05b2d6614 chore: retire the Everything Claude Code name, ECC only (#3330)
* chore: retire the Everything Claude Code name, ECC only

Replace the expanded product name and the everything-claude-code slug
with ECC across READMEs, translated docs, harness folders, skills,
commands, scripts and examples. Repo URLs now point at affaan-m/ECC.

Rename repo-internal artifacts to ecc forms (ecc-conventions skill,
ecc-guardrails, ecc-research-playbook, ecc-team-config, ecc-instincts
with ecc-* ids) and update .claude/ecc-tools.json.

Legacy install ids, plugin dirs, package names and MCP prefixes stay
where existing installs resolve against them. The codex global-state
check and harness-audit repo detection accept the new name first and
the legacy one as a fallback. The Discord bot prefers ~/GitHub/ECC and
falls back to the nested legacy checkout path.

Refresh the skill-triggers registryDigest for the changed skill text.

* fix(ecc-tools): drop managed paths to the removed Claude repo skill

.claude/skills/<repo-skill>/SKILL.md was deleted in #2770 but stayed listed in
ecc-tools.json and the team config. Remove those entries and point the Claude
Code adapter at the existing .agents/skills/ecc-conventions/SKILL.md.
2026-10-01 17:50:41 -05:00

3.4 KiB

description, agent, subtask
description agent subtask
エージェント、フック、MCP、パーミッション、シークレットのサーフェスに対してAgentShieldを実行します。 ecc:security-reviewer true

セキュリティスキャンコマンド

現在のプロジェクトまたはターゲットパスに対してAgentShieldを実行し、所見を優先順位付きの修正計画に変換します。

使い方

/security-scan [path] [--format text|json|markdown|html] [--min-severity low|medium|high|critical] [--fix]

  • path(オプション): デフォルトは現在のプロジェクト。.claude/パス、リポジトリルート、またはチェックインされたテンプレートディレクトリを使用。
  • --format: 出力形式。CIにはjson、引き継ぎにはmarkdown、スタンドアロンレビューレポートにはhtml。
  • --min-severity: 低優先度の所見をフィルタ。
  • --fix: 安全かつ自動修正可能と明示的にマークされたAgentShieldの修正のみを適用。

決定論的エンジン

パッケージ化されたスキャナーを優先:

npx ecc-agentshield scan --path "${TARGET_PATH:-.}" --format text

ローカルAgentShield開発の場合、AgentShieldチェックアウトから実行:

npm run scan -- --path "${TARGET_PATH:-.}" --format text

所見を作り出さないこと。AgentShieldの出力を信頼できるソースとして使用し、スキャナーの事実とフォローアップの判断を分離。

レビューチェックリスト

  1. まずアクティブなランタイムの所見を特定:
    • ハードコードされたシークレット
    • 広範なパーミッション
    • 実行可能なフック
    • シェル、ファイルシステム、リモートトランスポート、またはピン留めされていないnpxを持つMCPサーバー
    • 防御なしで信頼できないコンテンツを処理するエージェントプロンプト
  2. 低信頼度のインベントリを分離:
    • ドキュメントの例
    • テンプレートの例
    • プラグインマニフェスト
    • プロジェクトローカルのオプション設定
  3. criticalまたはhighの各所見について返却:
    • ファイルパス
    • 重大度
    • ランタイム信頼度
    • 重要な理由
    • 正確な修正方法
    • 自動修正が安全かどうか
  4. --fixが要求された場合、修正を適用する前に計画された編集を述べる。
  5. 修正後にスキャンを再実行し、前後のスコアを報告。

出力契約

返却内容:

  1. セキュリティグレードとスコア。
  2. 重大度とランタイム信頼度別の件数。
  3. 正確なパス付きのcritical/highの所見。
  4. 低信頼度の所見は別グループ。
  5. 修正順序。
  6. 実行されたコマンドとスキャンがローカル、CI、npxバックのいずれか。

CIパターン

強制ゲートのためにGitHub ActionsでAgentShieldを使用:

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

リンク

引数

$ARGUMENTS:

  • オプションのターゲットパス
  • オプションのAgentShieldフラグ