用途
agentic-actions-auditor 是一项针对调用 AI 编码智能体的 GitHub Actions 工作流的静态安全分析技能。它用于审计仓库的 GitHub Actions 工作流中 AI 智能体的安全性,审查调用 Claude Code Action、Gemini CLI 或 OpenAI Codex 的 CI/CD 配置,检查攻击者可控输入是否能到达 AI 智能体提示,评估智能体操作配置(沙箱设置、工具权限、用户允许列表),评估暴露工作流于外部输入的触发事件,以及调查从 GitHub 事件上下文经过 env: 块到 AI 提示字段的数据流。
主要能力
该技能可以:
- 在本地或从远程 GitHub 仓库发现工作流文件;
- 识别 AI 操作步骤,通过匹配已知 AI 操作引用(anthropics/claude-code-action、google-github-actions/run-gemini-cli、google-gemini/gemini-cli-action、openai/codex-action、actions/ai-inference);
- 跟随跨文件引用,解析复合操作和可复用工作流,发现其中可能隐藏的 AI 智能体(仅解析一层深度);
- 捕获与安全相关的配置,包括步骤级的 with: 输入字段和整个工作流的触发事件、环境变量与权限;
- 检测九类攻击向量:Env Var Intermediary、Direct Expression Injection、CLI Data Fetch、PR Target + Checkout、Error Log Injection、Subshell Expansion、Eval of AI Output、Dangerous Sandbox Configs、Wildcard Allowlists;
- 生成结构化的发现报告,包含标题、严重性、文件、步骤、影响和证据。
使用方式
用户可以提供 GitHub 仓库 URL 或 owner/repo 标识符以进行远程分析,否则使用本地分析模式。远程分析使用 gh api 列出并获取 .github/workflows 目录下的 YAML 文件;本地分析使用 Glob 定位工作流文件。随后按顺序执行:发现工作流文件、识别 AI 操作步骤、捕获安全上下文、分析攻击向量、报告发现。跨文件解析、输入映射、远程获取等完整解析流程记录在 references/cross-file-resolution.md 中。
适用场景
- 审计仓库的 GitHub Actions 工作流中的 AI 智能体安全;
- 审查调用 AI 编码智能体的 CI/CD 配置;
- 检查攻击者可控输入是否能到达 AI 智能体提示;
- 评估智能体操作配置(沙箱设置、工具权限、用户允许列表);
- 评估将工作流暴露于外部输入的触发事件(pull_request_target、issue_comment 等);
- 调查从 GitHub 事件上下文经过 env: 块到 AI 提示字段的数据流。
限制
该技能不适用于:分析不使用任何 AI 智能体操作的工作流(应使用通用 Actions 安全工具);在调用方工作流上下文之外审查独立的复合操作或可复用工作流;执行运行时提示注入测试(本技能是静态分析指引,不是利用);审计非 GitHub 的 CI/CD 系统(Jenkins、GitLab CI、CircleCI);自动修复或修改工作流文件(本技能仅报告发现,不修改文件)。
关于参考文献
该技能引用上游文档的特定修订版本,归属 Trail of Bits,许可证为 CC-BY-SA-4.0。技能的详细攻击向量检测依赖 references/ 目录下的多个文件,包括 foundations.md 以及各向量的说明文件。
暂未提供的信息
关于该技能的具体收费、价格、平台支持范围、运行性能指标或效果评估等事实,现有资料暂未提供。
引用文档
以下为作者声明的引用来源,保留指定版本、署名和许可。
- trailofbits/skills/plugins/agentic-actions-auditor/skills/agentic-actions-auditor/SKILL.md — 署名:Trail of Bits;许可:CC-BY-SA-4.0;版本:
5c15f4f5644b4bd3d48882a802a7232d501852b6。