1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | agent-platform-access-audit-google-skills |
| 作者/维护者 | Google(官方) |
| 来源链接 | https://github.com/google/skills/tree/main/skills/cloud/agent-platform-access-audit |
| 许可证 | Apache-2.0 |
| GitHub Stars / Forks | 21,805 / 1,861(所属仓库整体数字,不代表本技能自身热度;GitHub API,2026-11-08 读取) |
| 最新版本 | 技能内标注 1.0.0;仓库主分支最近一次提交 2026-11-06 |
| 安装方式 | 把技能目录复制进 agent 的 skills 目录;需要 Cloud Audit Logs 已汇入 BigQuery |
数据来源:上述数字取自 GitHub API;功能与评分依据来自技能正文与官方文档。
2. 功能介绍与亮点
一句话:查清楚一个 AI agent 到底碰过哪些资源、以谁的身份在动、以及被什么策略拦下——全部通过 Cloud Audit Logs 做只读分析。
- 访问面盘点:列出 agent 访问过的资源与服务,勾出真实的爆炸半径。
- 身份归因:找出 agent 实际代表的主要主体,区分「服务账号干的」与「用户代办的」。
- 拒绝原因分流:把
PERMISSION_DENIED分成 VPC Service Controls 边界拦截与 IAM 权限不足两类——这两种的处置完全不同。 - 只读:不改 IAM、不改边界、不写任何资源。
- 边界清楚:监控告警配置、非审计日志、写操作都不在范围内。
3. 适用场景
所属分类:安全与合规。
- 上线前想知道 agent 的服务账号能碰到什么、实际碰过什么的安全团队;
- 排查 agent 突然
PERMISSION_DENIED、需要分清是边界还是权限的问题; - 做 agent 权限最小化、需要一份实际访问清单的工程团队;
- 审计第三方 agent 在云上的行为边界。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 技能目录安装,按描述触发 |
| Codex | 需适配 | 技能正文通用,gcloud 与 BigQuery 调用需按平台调整 |
| OpenClaw | 需适配 | 需要平台支持技能目录并允许执行本地命令 |
| Hermes Agent | 未验证 | 未找到该平台的接入示例 |
5. 推荐理由
agent 的权限问题比人难查:它用的是服务账号,动作分散在多个 API 上,出了拒绝还分不清是边界还是 IAM。这个技能把审计日志当成事实来源,给出「访问了什么、以谁的身份、被什么拦」三个问题的查法——对要给 agent 做权限收敛的团队,这比读策略文档更接近真相。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Google 官方出品;所属仓库 21,805 stars 是整个合集热度,不代表本技能自身热度 |
| 可用性 | 8 | 查询路径与分流判断写清楚了;前置是审计日志已汇入 BigQuery |
| 安全性 | 9 | 见下方清单;只读查询,不修改任何策略与资源 |
安全性检查清单:
| 项 | 结果 |
|---|---|
| ① 执行 shell 与权限 | 通过 gcloud/BigQuery 做只读查询,作用域限于项目审计日志 |
| ② 联网外发 | 只与 Google Cloud 端点通信 |
| ③ 凭据 | 使用既有 gcloud 凭据,不要求写进对话 |
| ④ 可疑指令 | 未见注入或夹带推广 |
| ⑤ 作者信誉 | Google 官方仓库,Apache-2.0 |
| ⑥ License | Apache-2.0,全文可查 |
| ⑦ 维护时间 | 2026-11-06 仍在更新 |
扣分点:依赖审计日志的完整性与保留期;日志没开全时结论会缺角。
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| agent-platform-architecture-google-skills | 企业级 Gemini 平台架构设计 | 管「怎么搭」;本技能管「搭完之后谁碰了什么」 |
| codeql-trailofbits-skills | 源码级静态安全分析 | 看代码;本技能看运行时的审计日志 |
| semgrep-trailofbits-skills | 快速静态扫描 | 同上;本技能面向已部署 agent 的实际行为 |
核心差异:同类多在代码或架构层,它用审计日志回答「这个 agent 实际做了什么」。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价(2026-11-08)。
9. 其他补充
- 技能内标注 1.0.0,随官方仓库更新。
- 属于
google/skills合集(180 个技能),可按需只装这一条。
10. 安装使用方式
git clone https://github.com/google/skills
mkdir -p ~/.claude/skills
cp -r skills/skills/cloud/agent-platform-access-audit ~/.claude/skills/
装好后说「查一下这个 agent 最近访问了哪些资源、有没有越界」,它会先确认审计日志的位置再跑查询。
11. 注意事项
- 需要 Cloud Audit Logs 已汇入 BigQuery,否则查不到完整轨迹。
- 审计日志有保留期,超过窗口的行为无法回溯。
- 它只读,不会替你改 IAM 或边界。
- 查询会带使用归因标记,企业合规上需先确认。