Google Workspace CLI Agent Skills

Google Workspace CLI Agent Skills 是 googleworkspace/cli 仓库里的技能集合。它把 Gmail、Drive、Calendar、Sheets、Docs 等 API 的调用方式写成 Agent 可读取的 SKILL.md，并用 persona 与 recipe 组合跨服务任务。实际执行仍由 gws CLI 完成。它适合希望让 Agent 处理 Workspace 日常工作的个人与团队，前提是愿意认真管理 OAuth scopes、云端写操作和敏感数据。

先安装 gws CLI 并完成最小范围的 OAuth，再把需要的 Skills 加到目标 Agent 宿主。第一次只用读取命令验证身份与输出，确认 scopes 后再开放写操作。

请帮我安装 Google Workspace CLI Agent Skills。项目地址是 https://github.com/googleworkspace/cli。先读取 README.md、docs/skills.md、skills/gws-shared/SKILL.md、SECURITY.md 和 LICENSE，说明将安装 gws CLI 还是只安装 Skills。优先从 GitHub Releases 安装与系统架构匹配的 gws 二进制，也可以按我的环境选择 `npm install -g @googleworkspace/cli` 或 `brew install googleworkspace-cli`。随后只安装任务需要的 Skills，例如 `npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-drive`。OAuth 先使用 `gws auth login -s drive,gmail,sheets` 一类最小服务集合。不要输出 token、client secret 或 credentials 文件内容。发送消息、共享文件、修改表格、创建事件和删除数据前必须向我确认，并优先使用 `--dry-run`。完成后只执行只读列表命令验证。

npx skills add https://github.com/googleworkspace/cli

1. 1
   安装并检查 gws CLI

   从 Releases 下载预编译二进制，或使用 `npm install -g @googleworkspace/cli` 与 `brew install googleworkspace-cli`。运行 `gws --version` 和 `gws --help` 确认 PATH 与版本。

2. 2
   配置最小 OAuth 范围

   有 gcloud 时运行 `gws auth setup`，随后用 `gws auth login -s drive,gmail,sheets` 只选择本次需要的服务。手动流程则把 Desktop OAuth 客户端保存到 README 指定的配置路径。

3. 3
   安装必要 Skills

   用 `npx skills add` 安装整个仓库，或只安装 `skills/gws-drive`、`skills/gws-gmail` 等目录。少装一些更容易核对宿主加载了哪些说明与命令。

4. 4
   用只读请求验证

   先执行 `gws drive files list --params '{"pageSize": 5}'`，检查返回的账号、字段与数量。不要在首次验证时发送邮件、共享文件或修改数据。

5. 5
   逐步开放写操作

   选择一个 recipe，查看它将访问的服务与对象。能使用 `--dry-run` 的命令先预演，确认请求内容、目标与 scopes 后再执行，并保留人工批准。

这套 Skills 的优势来自 CLI 与技能说明在同一仓库维护，命令、认证方式和工作流例子能互相对应。95 个实际 Skill 覆盖面已经很广，结构化 JSON、schema 与 dry-run 也适合 Agent 调用。使用成本主要落在 Google Cloud OAuth、scope 控制和外部写操作审核上。项目仍处于 v1 前阶段，README 对 Skill 总数的两处描述也不一致，因此更适合先选少量服务试用。本页只做公开资料核验，没有完成安装或功能实测。