用途：当任务应通过 Google Workspace CLI 执行，而非手写 HTTP 请求或临时 API 封装时使用。适用于与 Drive、Gmail、Sheets、Docs、Slides、Calendar、Chat、Tasks、People、Meet 或 Workspace Admin API 交互，需要结构化 JSON 输出、构建请求前查看 Google API schema，以及可在本地、CI 或无头环境重复运行的 CLI 工作流。
主要能力：安装可用 npm install -g @googleworkspace/cli；通过 bash scripts/check-prereqs.sh 检查二进制与认证状态；用 gws <service> --help 浏览命令，用 gws schema <service.resource.method> 查看方法 schema；支持只读 list/get、创建更新、内联 JSON 请求体、分页、文件上传下载等命令模式。
使用方式：先确认 gws 在 PATH 中并检查认证状态；构建命令前先查看目标方法 schema；优先只读命令，写入、更新、删除前先与用户确认意图，条件允许时用 --dry-run 做本地验证。认证可选本地交互 gws auth setup 与 gws auth login，或服务账号方式 export GOOGLE_APPLICATION_CREDENTIALS=/path/to/key.json 后 gws auth status，CI/无头环境优先导出凭据或服务账号执行。常用示例：gws drive files list --params '{"pageSize": 10}' --format json；gws schema calendar.events.insert；gws drive files list --params '{"pageSize": 100}' --page-all；gws drive files create --json '{"name": "report.pdf"}' --upload ./report.pdf。
适用场景：需要对 Workspace API 做可重复、脚本化调用，并让智能体读取 JSON 结果的场景。
限制：绝不回显密钥，不打印 token、OAuth 客户端密钥或服务账号 JSON 内容；写入操作需确认目标资源、身份与范围；--page-all 会改变输出为 NDJSON，需按行解析；403 或权限不足时先确认当前身份、API 启用、scope 与资源共享；方法未知时先用 gws <service> --help 确认别名；schema 校验失败时重新运行 gws schema 并比对必填字段名。其他安装细节与常见命令模板见 references/REFERENCE.md。