owasp/secure-agent-playbookOWASP セキュアエージェント プレイブック プロジェクト
AIエージェント向けのオープンソースセキュリティプレイブック。OWASPに基づいた構造化された手順により、エージェントがコードレビューからAIエージェントのセキュリティ監査まで、セキュリティエンジニアリングタスクを実行できるようにします。
プレイブックがなければ、AIエージェントに「セキュリティのためにコードをレビューして」と依頼しても、表面的なチェックリストしか得られません。これらのプレイを使えば、エージェントはOWASPに基づいた構造化された手順に従い、すべての脆弱性クラスを体系的にテストし、CWEマッピング、OpenCRE相互参照、証拠スニペット、具体的な修正コードを含む検出事項を生成します。
これはフレームワークでもライブラリでもありません。インポートするコードはありません。
各プレイは、チェックリスト、判断基準、出力テンプレートを備えたステップバイステップのセキュリティ手順です。AIエージェントはこの手順に従って、一貫した証拠ベースの検出事項を生成します。SOCアナリストのプレイブックのようなものだと考えてください — ただし、AIエージェントが実行するために書かれています。
Claude Codeを使用する場合(推奨):
ステップ1 — プラグインマーケットプレイスを登録します:
/plugin marketplace add OWASP/secure-agent-playbook
ステップ2 — スキルセットをインストールします:
/plugin install code-security-skills@agent-security-playbook
/plugin install ai-security-skills@agent-security-playbook
ステップ3 — 会話の中でタスクに言及してスキルを使用します:
"Review this code for security issues"
"Scan my dependencies for CVEs"
"Audit this MCP server configuration"
"Test this chatbot for prompt injection"
Claudeはコンテキストに基づいて関連するスキルを自動的に有効化します。利用可能なすべてのスキルについてはスキルカタログを、結果がどのように表示されるかについては出力例を参照してください。
組織プラグイン — Organization Pluginsを介してインストールするClaude組織管理者向け:
secure-agent-playbook.zipをダウンロードします注意: GitHubの「Download ZIP」ボタンは使用しないでください — ファイルがサブディレクトリにネストされ、プラグインバリデータが拒否します。常にリリースアセットのzipを使用してください。
ローカル開発 — GitHubの代わりにローカルクローンからテストする場合:
/plugin marketplace add /path/to/agent-security-playbook
/plugin install code-security-skills@agent-security-playbook
/plugin install ai-security-skills@agent-security-playbook
Claude Codeを使用しない場合:
任意のAIエージェントまたは手動使用のための手順として、プレイを直接参照します:
plugins/ai-security-skills/plays/agent-security-audit.mdの手順に従ってください」code-security-skills)| スキル | 機能 | こう言う | OWASP参照 |
|---|---|---|---|
code-review-security | Top 10 + ASVSにマッピングされたセキュリティコードレビュー | "Review this code for security issues" | Top 10, ASVS |
sca-audit | 到達可能性分析を伴う依存関係CVEスキャン | "Scan my dependencies for CVEs" | A06:2021 |
secrets-scan | ハードコードされた認証情報とAPIキーの検出 | "Scan for hardcoded secrets" | CWE-798 |
api-security-review | OWASP API Top 10 (2023)に対するAPIレビュー | "Review this API for security" | API Top 10 |
web-security-review | OWASP Top 10 (2021)に対するWebアプリレビュー | "Review this web app for OWASP Top 10" | Top 10 |
mobile-code-review | OWASP MASVS v2.1.0に対するネイティブAndroid/iOSソースレビュー | "Review this mobile app for security" | MASVS v2.1.0 |
iac-security-review | IaCセキュリティ (Terraform、K8s、CloudFormation) | "Review this Terraform for security" | CIS Benchmarks |
securability-engineering | 本質的にセキュア化可能なコードの生成 (FIASSE v1.0.4) | "Generate secure code for..." | FIASSE v1.0.4 |
securability-engineering-review | コードのセキュア化可能性の評価 (0-10 SSEMスコアリング) | "Assess the securability of this code" | FIASSE v1.0.4/SSEM |
prd-securability-enhancement | コードが書かれる前に、ASVSカバレッジとFIASSE SSEM要件でPRD/仕様を強化 | "Harden this PRD" / "Map features to ASVS" | ASVS, FIASSE v1.0.4 |
security-guidance | セキュリティに敏感なコードに対する自動トリガーASVSガイダンス | (自動トリガー) | ASVS 5.0 |
ai-security-skills)| スキル | 機能 | こう言う | OWASP参照 |
|---|---|---|---|
agent-security-audit | エージェントの権限、インジェクション面、データ持ち出し経路の監査 | "Audit this agent's security" | LLM Top 10 |
llm-risk-assess | LLM Top 10 2025に対するLLMアプリ評価 | "Assess LLM risks for this app" | LLM Top 10 |
agentic-ai-risk-assess | Top 10 Agentic 2026に対するエージェント型アプリ評価 | "Assess agentic AI risks" | Agentic Top 10 |
mcp-server-review | MCPサーバーのセキュリティレビュー | "Review this MCP server" | LLM Top 10 |
prompt-injection-test | プロンプトインジェクションテスト (Arcanum PI Taxonomy) | "Test for prompt injection" | LLM01 |
multi-agentic-threat-model | CSA MAESTRO 7層脅威モデリング | "Model threats for this multi-agent system" | CSA MAESTRO |
ai-security-verification | OWASP AISVS (13カテゴリ)に対するAIアプリケーション検証 | "Verify this AI app against AISVS" | AISVS |
エージェントは、スキルを呼び出して構造化されたレポートを生成する自律型セキュリティスペシャリストです。各エージェントは、焦点を絞ったシステムプロンプト、スコープ設定されたツールアクセス、プリロードされたスキルを持っています。個別に、または連携チームとして使用できます。
| エージェント | 焦点 | 呼び出すスキル |
|---|---|---|
code-security-reviewer | コードの脆弱性、シークレット、Webセキュリティ | code-review-security, secrets-scan, web-security-review |
dependency-auditor | サプライチェーンと依存関係のCVEリスク | sca-audit |
api-security-reviewer | OWASP API Top 10に対するAPIセキュリティ | api-security-review |
mobile-security-reviewer | OWASP MASVS v2.1.0に対するネイティブAndroid/iOSソース | mobile-code-review |
ai-security-assessor | エージェント設定、MCPサーバー、LLMアプリのリスク | agent-security-audit, mcp-server-review, llm-risk-assess, prompt-injection-test |
security-team-lead | スペシャリストの調整、レポートの統合 | securability-engineering-review |
スタンドアロン使用 — 任意のエージェントを直接呼び出します:
"Use code-security-reviewer to review src/"
"Use dependency-auditor to scan this project"
チーム評価 — エージェントチームが有効な場合、チームリードはスペシャリストを並行して派遣し、検出事項を単一のレポートに統合します:
"Run a full security assessment of this project"
チームリードはターゲットのスコープを設定し、関連するスペシャリストを派遣し(焦点領域が存在しないものはスキップ)、検出事項を重複排除し、クロスドメインのリスクチェーンを特定し、templates/report.mdを使用して統合レポートを生成します。
エージェントチームには
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1が必要です。セットアップについてはClaude Codeドキュメントを参照してください。個々のエージェントはこのフラグなしで動作します。
Node.js/Expressコードベースで"Review src/auth/ for security issues"を実行すると、次のような検出事項が生成されます:
Security Code Review — src/auth/
Scope: Node.js/Express, server-side, processes user credentials
Findings: CRITICAL 1 | HIGH 2 | MEDIUM 1 | LOW 0
src/auth/login.js:42idパラメータを介して、usersテーブル全体を抽出したり、認証をバイパスしたり、任意のSQLを実行したりできます// src/auth/login.js:42
const user = await db.query("SELECT * FROM users WHERE id=" + req.params.id);
const user = await db.query("SELECT * FROM users WHERE id = $1", [req.params.id]);
すべてのスキルは、重大度、CWE、証拠、修正コードを含む構造化された検出事項を生成します。 完全なサンプル評価レポートについては
examples/を参照してください。
差別化要因 — AIエージェント時代のために専用に構築されたセキュリティ手順。ai-security-skillsプラグイン内にバンドルされています。