Agent Skills
返回列表
🤖

谷歌工作空间CLI

AI Agent 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3c6cb52e/breeze-google-workspace-cli。

技能介绍

要解决的问题

运维 Google Workspace 时，通常面对三堆麻烦：管理 Gmail、Drive、Calendar 的 API 分散且参数冗长，写脚本前要先翻文档确认字段；批量操作一旦参数填错，可能在共享目录里误删文件或误改权限；安全配置审计（转发规则、外部分享、OAuth 授权）靠人工逐项检查，既慢又容易漏。

技能如何工作

这个技能围绕开源命令行 gws 展开。该 CLI 运行时根据 Google Discovery Service 的描述动态生成命令面，理论上覆盖全部受支持的 Workspace API。

核心工作流分三步：

  • 确认命令面：在写入自动化脚本前，先用 gws --help、gws --help 或 gws schema 确认具体方法的入参结构，避免凭记忆拼参数。
  • 跑通场景：技能内置四条工作流——Gmail 邮件收发与检索、Drive 文件与表格管理、Calendar 日程与空闲时间查询、安全审计与修复命令生成。发现型命令支持通过 --params 传 query/path 参数、--json 传请求体。
  • 借助本地 Python 工具：gws_doctor.py 做安装与认证前检查，auth_setup_guide.py 引导 OAuth 配置，gws_recipe_runner.py 充当命令模板目录，workspace_audit.py 扫描常见风险项并生成修复命令，output_analyzer.py 过滤和聚合 gws 输出的 JSON/NDJSON。

自动化方面，批量破坏性操作前应先加 --dry-run 预览；结果集较大时用 --page-all 以 NDJSON 流式读取；多步骤流程优先调用 + 前缀的 helper 命令，而不是手工串联原生 API 调用。

适用边界

gws 目前处于 pre-v1.0 阶段，版本间可能出现破坏性变更，技能文档中标注 (verify) 的命令必须在本机版本上重新核对。OAuth token 有效期为一小时，长驻脚本需要处理重认证。执行 Admin API 相关审计项需要 Workspace 管理员权限，且必须预先在 Google Cloud Console 完成项目配置。批量请求还可能触发各服务的速率限制（429）。

使用场景

  • 需要在 CI 里给测试邮箱自动发信并检查垃圾邮件标记，要求命令参数先经 --dry-run 校验。
  • 批量归档共享云盘里旧文件前，要先查看 sharing 权限字段，再按分页导出完整清单。
  • 每日 standup 前要收集团队日历空闲时段，生成会议事件并把链接写回文档。
  • 接手 Workspace 租户后要逐项核对外部分享、转发规则与 OAuth 授权，输出修复命令。

适合人员

  • 负责 Workspace 租户配置的平台工程师，需要把目录、安全策略和审计结果脚本化。
  • 管理 Gmail、Drive、Calendar 的运维工程师，希望减少手写 API 调用和参数核对时间。
  • 在 CI 里跑邮件和文档回归测试的开发工程师，需要稳定可校验的 gws 命令模板。
  • 审计数据外泄风险的安全工程师，关注外部分享、转发规则和第三方 OAuth 授权。