安全代理手册

一个面向 AI 代理的开源安全手册。结构化、以 OWASP 为基础的程序，使代理能够执行安全工程任务——从代码审查到 AI 代理安全审计。

为什么使用这个？

没有手册时，让 AI 代理“审查我的代码安全性”只会给你一份表面化的检查清单。有了这些剧本，代理会遵循结构化的、以 OWASP 为基础的程序——系统地测试每一类漏洞，生成带有 CWE 映射、OpenCRE 交叉引用、证据片段和具体修复代码的发现。

一致的方法论——每次评估都遵循文档化的程序，而非临时提示。结果在多次运行和不同审查者之间可复现。
结构化、可操作的输出——发现包含严重性、CWE、证据和带有代码示例的修复步骤。没有模糊的警告。
跨标准可追溯性——发现通过 OpenCRE 链接到 CWE、ASVS、WSTG 和 NIST 800-53，用于合规映射。
18 项安全技能——从依赖项 CVE 扫描到提示注入测试再到多代理威胁建模。可作为 Claude Code 插件安装，也可独立使用。
不仅限于 Claude Code——技能是 Claude Code 插件；剧本是任何 AI 代理都能遵循的独立程序。

这是什么

这不是框架或库。没有可导入的代码。

每个剧本都是一个分步安全程序，包含检查清单、决策标准和输出模板。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 会根据上下文自动激活相关技能。查看技能目录了解所有可用技能，查看示例输出了解结果的样子。

组织插件——对于通过组织插件安装的 Claude 组织管理员：

前往最新发布
从发布资源中下载 secure-agent-playbook.zip
在组织设置 > 插件 > 添加插件处上传该 zip

注意： 不要使用 GitHub 的“Download ZIP”按钮——它会把文件嵌套在子目录中，插件验证器会拒绝。请始终使用发布资源 zip。

组织技能——对于在组织设置 > 技能上传单个技能的 Claude 组织管理员：

前往最新发布
下载你想要的每个技能的 zip（例如 web-security-review.zip）
在组织设置 > 技能 > 上传技能处上传

注意： 技能上传会拒绝超过 200 个文件的 zip，因此完整的 secure-agent-playbook.zip 无法在那里上传——请使用单个技能的 zip。要从克隆构建它们，请运行 scripts/package_skills.sh 并从 dist/skills/ 上传。

本地开发——要从本地克隆而非 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 与代理安全（`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

[CRITICAL] 用户查询中的 SQL 注入

CWE：CWE-89
OpenCRE：CRE-764-507 — 注入防护
OWASP 参考：A03:2021 注入
位置：src/auth/login.js:42
影响：攻击者可以通过精心构造的 id 参数提取整个 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 代理时代打造的安全程序。捆绑在 ai-security-skills 插件内。

最受欢迎

secure-agent-playbook