1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | agent-owasp-compliance（github/awesome-copilot 仓库 skills 目录下子技能） |
| 项目自述名称 | Awesome GitHub Copilot |
| 作者/维护者 | GitHub（GitHub 组织官方仓库） |
| 来源链接 | https://github.com/github/awesome-copilot/tree/main/skills/agent-owasp-compliance |
| 许可证 | MIT（GitHub API 获取，仓库级） |
| GitHub Stars / Forks | 39,068 / 4,956（GitHub API，截至 2026-09-16；数字为整个合集仓库层面，不代表本子技能自身热度） |
| 最新版本 | 无独立版本号，随仓库滚动更新；本子技能自 2026-04-09 加入后未再修改 |
| 安装方式 | GitHub CLI 一条命令，或手动下载 SKILL.md（见第 10 章） |
2. 功能介绍与亮点
agent-owasp-compliance 把“AI Agent 系统是否安全”这个模糊问题，拆成 OWASP Agentic Security Initiative（ASI）Top 10 十条可逐项核验的具体风险，覆盖提示词注入防护、工具调用治理、越权代理、权限提升、信任边界、审计日志、身份管理、策略绕过、供应链完整性、行为异常监测。
每条风险都配有：判断标准（该找什么信号）、可直接复用的 Python 检测函数（基于 pathlib 遍历代码库、用正则匹配通过/失败模式，纯本地静态分析，不联网、不执行被扫描代码）、以及一段“通过示例”与“失败示例”代码对照。技能末尾给出标准化的合规报告模板（X/10 Controls Covered 表格 + 关键缺口 + 修复建议），以及一份可用于快速人工自查的十问清单，不具备编程环境时也能照单逐条核对。
亮点：十条风险映射清晰、每条都可操作（不是泛泛而谈的安全建议）；检测逻辑本身就是纯 Python 标准库代码，复制即可运行，无需额外依赖或 API Key；作为官方仓库收录条目，格式规范、长期在线。
3. 适用场景
固定分类：安全与合规
- 准备把 AI Agent 系统投入生产前，想对照 OWASP ASI 十大风险做一次系统性安全自查的开发者
- 安全团队为 Agent 项目出具合规评审报告，需要一份结构化、可复现的检查清单而非临场发挥
- 已经改动过 Agent 的工具调用、权限模型或多 Agent 通信逻辑，想验证改动是否收紧了对应风险面
- 面试或代码评审场景下，快速判断一个 Agent 项目的安全成熟度处于哪个阶段
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 标准 SKILL.md 格式（YAML front matter + 指令正文），无绑定资源、无 Copilot 专有语法，可直接复制进本地 skills 目录使用 |
| Codex | 需适配 | 实测核验（2026-09-16 抓取第三方教程）：Codex CLI 不会自动发现 ~/.codex/skills 下的技能，需手动通过 -f 参数或标准输入显式引用文件内容，非开箱即用 |
| OpenClaw | 未验证 | 已抓取材料未提及 OpenClaw 支持情况，未为此单独搜索 |
| Hermes Agent | 未验证 | 已抓取材料未提及 Hermes 支持情况，未为此单独搜索 |
5. 推荐理由
市面上大多数“Agent 安全审计”技能给的是一套需要人工判断的检查方向，agent-owasp-compliance 的差异化在于把每条风险都落到了可直接运行的检测代码和明确的通过/失败判据，输出是结构化报告而非一段散文式点评。对初中级用户而言，这意味着不需要先懂安全审计方法论，跟着模板走一遍就能拿到一份看得懂、改得动的合规现状清单，也降低了“审计流于走过场”的概率。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 发布方为 GitHub 官方组织仓库；子技能自身暂无独立第三方评价或讨论，所属合集仓库 39,068 星由 400 余个子技能共享，不代表本技能个体热度，未查到可支撑上调的独立证据 |
| 可用性 | 8 | 检测代码为纯 Python 标准库、零依赖零配置，复制即可运行；文档含完整示例与报告模板；仓库整体持续活跃（最近提交为今日），但本子技能文件自 4 月加入后未再更新，暂不到“近 3 个月”档 |
| 安全性 | 9 | 纯本地静态分析：只读取并正则匹配用户自己的代码库文本，不联网、不执行被扫描的代码、无需凭据；官方仓库、完全开源可审计；SKILL.md 中出现的“pip install agent-governance-toolkit”是对 Microsoft 官方修复工具的主题相关引用，非无关品牌植入 |
综合评分：8.0（三项均值）
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| agent-security-audit（OWASP Secure Agent Playbook） | 六步式 Agent 整体安全审计流程（权限清单、注入面分析、越权代理、外泄路径、工具注入、防护栏评估） | 偏开放式的人工分析引导，未绑定某个命名标准的固定条目，产出是叙述性审计报告；agent-owasp-compliance 则逐条对应 OWASP ASI Top 10 的十个编号风险，配现成检测代码与量化的 X/10 覆盖表 |
| claude-code-owasp | 面向 Claude Code 场景的 OWASP 相关安全检查 | 聚焦传统 Web/代码安全的 OWASP 条目，不针对 Agent 特有的工具调用、越权代理、信任边界等风险 |
| agent-governance（github/awesome-copilot 同仓库） | Agent 治理模式参考（权限控制、审计追踪、信任评分设计） | 提供的是治理体系“该怎么设计”的模式库，属事前设计参考；agent-owasp-compliance 是“设计完了对不对”的事后核验工具，两者服务不同工作环节 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价；数个技能聚合站点收录了其内容摘要，但均未见署名评论或使用反馈。
9. 其他补充
技能末尾附带一份“十问快速自查清单”，不具备代码执行环境时也可直接照单人工核对，降低了使用门槛。
10. 安装使用方式
通过 GitHub CLI（推荐，需 v2.90.0+）：
gh skills install github/awesome-copilot agent-owasp-compliance手动安装：
mkdir -p ~/.claude/skills/agent-owasp-compliance
curl -sSL https://raw.githubusercontent.com/github/awesome-copilot/main/skills/agent-owasp-compliance/SKILL.md \
-o ~/.claude/skills/agent-owasp-compliance/SKILL.md安装后注意事项：无绑定脚本或资源文件，纯 Markdown + 内嵌 Python 参考代码，安装后无需重启；在对话中描述“检查我的 Agent 是否符合 OWASP ASI 合规要求”等需求即可触发，或显式引用技能名调用。检测代码默认扫描当前项目的 *.py 文件，其他语言项目需自行改写正则模式。
11. 注意事项
- 内置的十条检测函数以正则模式匹配为主，属于启发式判断而非严格静态分析，可能有漏报（如用了检测清单之外的实现方式）或误报（如同名变量恰好命中关键词），结果应作为审计起点而非终审结论
- 目前仅提供 Python 代码库的现成检测逻辑，其他语言项目需要自行改写正则模式或改用清单里的“十问快速自查”做人工核对
- 本子技能自 2026-04-09 加入仓库后未见后续更新，OWASP ASI 标准本身若有版本迭代，检测条目可能滞后