安全智能体行动手册

面向 AI 智能体的开源安全行动手册。基于 OWASP 的结构化规程，使智能体能够执行安全工程任务——从代码审查到 AI 智能体安全审计。

目录

• 为什么要用它？
• 这是什么
• 快速开始
• 技能目录
• 智能体
• 示例输出
• 规程
• 架构
• OWASP 基础
• 相关项目
• 贡献指南

为什么要用它？

如果没有行动手册，让 AI 智能体"审查我的代码是否存在安全问题"只会得到一份浅层检查清单。有了这些规程，智能体会遵循结构化的、基于 OWASP 的流程——系统性地测试每一类漏洞，并产出包含 CWE 映射、OpenCRE 交叉引用、证据片段以及具体修复代码的发现项。

• 一致的方法论——每次评估都遵循文档化的流程，而非临时起意的提示。结果可在不同运行和审查者之间复现。
• 结构化、可操作的输出——发现项包含严重性、CWE、证据和带代码示例的修复步骤。没有含糊的警告。
• 跨标准可追溯性——发现项通过 OpenCRE 关联到 CWE、ASVS、WSTG 和 NIST 800-53，便于合规映射。
• 17 项安全技能——从依赖项 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 组织管理员：

1. 前往最新版本页面
2. 从发布资产中下载 secure-agent-playbook.zip
3. 在组织设置 > 插件 > 添加插件处上传该 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）

AI 与智能体安全（ai-security-skills）

智能体

智能体是自主安全专家，它们调用技能并生成结构化报告。每个智能体都有聚焦的系统提示词、受限的工具访问权限和预加载的技能。你可以单独使用它们，也可以作为协同团队使用。

独立使用 — 直接调用任意智能体：

"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 参数提取整个用户表、绕过身份验证或执行任意 SQL
• 证据：
  root@kitploit:~

  // src/auth/login.js:42
  const user = await db.query("SELECT * FROM users WHERE id=" + req.params.id);
  

• 修复建议：使用参数化查询：
  root@kitploit:~

  const user = await db.query("SELECT * FROM users WHERE id = $1", [req.params.id]);
  

• 置信度：高

每项技能都会产出包含严重性、CWE、证据和修复代码的结构化发现项。 完整的示例评估报告请参阅 examples/。

规程

AI/智能体安全规程

差异化优势——专为 AI 智能体时代打造的安全流程。随 ai-security-skills 插件一同打包。

代码与依赖分析规程

为任何代码库提供立竿见影的实用价值。随 code-security-skills 插件一同打包。

规划中

• 第 2 层：威胁建模、ASVS 验证、基础设施加固
• 第 3 层：WSTG 测试检查清单、DAST 编排、攻击面映射
• 第 5 层：SAMM 成熟度评估、合规映射、汇总报告

架构

三层设计——每一层都位于插件源码目录内，因此市场安装会将技能所需的一切都打包进来：

• plugins/<name>/agents/ — 具有聚焦系统提示词的自主安全专家，与各插件同置。每个智能体调用一项或多项技能，在隔离的上下文中运行，并生成结构化报告。既可单独工作，也可作为协同团队工作。
• plugins/<name>/skills/ — 遵循 Agent Skills 规范 的自包含 SKILL.md 文件。通过 plugins/code-security-skills/ 和 plugins/ai-security-skills/ 分发，并通过 .claude-plugin/marketplace.json 在市场注册。每项技能概括一个流程，并引用同一插件内对应的规程。
• plugins/<name>/plays/ — 完整的参考规程，包含详细检查清单、表格、决策标准和示例。技能通过引用这些内容实现全面覆盖。
• plugins/<name>/templates/ 和 plugins/<name>/data/ — 输出模板（finding.md、report.md）和 OWASP 参考数据集（FIASSE v1.0.4、ASVS v5.0、安全代码提示词），技能在运行时加载。

智能体负责编排，技能负责执行，规程提供完整流程。贡献者编辑规程。这意味着该行动手册适用于任何 AI 智能体（只需让它参照某个规程执行），而 Claude Code 用户则可获得基于插件的安装方式，连同智能体和技能一起使用。

OWASP 基础

所有规程均引用 OWASP 标准和数据集：

• OWASP Top 10 — Web 应用风险
• OWASP API Security Top 10 — API 特有风险
• OWASP Top 10 for LLM Applications — AI/LLM 风险
• OWASP Agentic Security Initiative — 自主智能体风险（Agentic 应用 Top 10）
• OWASP ASVS — 安全验证要求
• OWASP MASVS — 移动应用安全验证标准
• OWASP AISVS — AI 安全验证标准
• OWASP WSTG — 测试方法论
• OWASP SAMM — 安全项目成熟度模型
• OWASP Cheat Sheet Series — 开发者安全指南
• OWASP FIASSE — 内在自适应与可安全化工程框架（v1.0.4）

相关项目

贡献指南

详细指南请参阅 CONTRIBUTING.md。

新增规程应：

• 解决一个定义明确的安全任务
• 包含清晰的触发条件（该规程应在何时运行？）
• 遵循带检查点的结构化流程
• 使用插件内的 templates/finding.md 格式产出发现项
• 在适用的情况下引用 OWASP 标准
• 优先使用现有工具（semgrep、trivy、osv-scanner、trufflehog），而不是重新实现检测逻辑
• 位于相应插件的 plays/ 文件夹内，以便随市场安装一起发布

许可证

依据 知识共享署名 4.0 国际（CC-BY-4.0）许可。上游 OWASP 项目内容的署名信息请参阅 THIRD_PARTY_NOTICES.md。