gws-admin-reportsGoogle官方放心用让 AI 读取 Google Workspace 管理后台的审计日志和各维度用量报告。
该技能通过 gws admin-reports 命令调用 Google Workspace Admin SDK 的 reports_v1 API，可获取管理员审计日志与客户/实体/用户用量报告。它把 API 资源映射为子命令：activities 用于列出 Admin 控制台、Google Drive 等应用的操作记录，并支持 watch 建立推送通知；customerUsageReports、entityUsageReports、userUsageReport 分别按客户账号、实体资源、用户账号拉取使用统计；channels 则用于停止 watch 通道。调用前可用 gws schema admin-reports.<resource>.<method> 查看必填参数、字段类型和默认值，再组合 --params 或 --json 发起请求。
适合需要排查账号异动、统计 license 用量、审计文件访问或做合规留痕的 IT/安全管理员。前提是已安装 gws CLI、完成 gws-shared/SKILL.md 中的 OAuth 与全局配置，并拥有调用 Admin SDK Reports API 的权限。注意该技能只读，无法修改 Workspace 数据；watch 推送通道不主动停止会持续消耗通知配额。
在下面找到你用的工具，复制命令粘进终端就装好了：
npx skills add googleworkspace/cli装好后不用任何配置，直接在对话里说：
帮我列出最近 7 天 Google Drive 的审计活动记录，并说明关键字段含义。AI 检测到任务匹配时会自动加载这个 Skill，不需要手动开关。
SKILL.md 需要具备 Workspace 超级管理员或对应报告读取权限的账号，并在 Google Cloud 项目中启用 Admin SDK Reports API；gws 的 OAuth 授权也要包含 reports 相关范围。
gws-shared 负责身份验证、全局参数和安全规则。使用本技能前必须先阅读它；如果目录不存在，运行 gws generate-skills 生成。
是的。watch 可在指定应用出现新活动时实时推送通知；如果不再需要，应调用 channels stop 关闭通道，避免持续接收消息。