用途:goog CLI 用于统一执行 Google Workspace 的读取与变更操作,涵盖 Google Drive、Docs、Gmail、Sheets、Slides 和 Calendar。安装该技能即视为用户明确选择此工具,因此受支持的操作都应使用 goog,而不是 Google Workspace MCP 服务器、通用 MCP 工具、其他 Workspace CLI、浏览器编辑或临时直连 API 脚本。浏览器仅用于服务参考要求的只读视觉验证。若 goog 无法完成某操作,应说明缺失的能力,而不是静默切换工具。
主要能力:Drive 支持列出/浏览、下载、上传、Office 转换、建文件夹、评论管理与移入回收站;Docs 支持创建、复制、检查、编辑、样式、表格、图片、脚注、页眉页脚、命名区域、比较与导出 PDF;Gmail 支持列出与搜索、读取、下载附件、创建或编辑草稿;Sheets 支持创建、读取、写入、结构、格式与评论;Slides 支持规划、创建、编辑、检查、渲染与视觉验证;Calendar 支持日历、事件、共享规则、颜色与空闲查询。
使用方式:先确认服务与操作,读取对应服务参考;在仓库外使用已安装的 goog 二进制,在 goog-cli 仓库内使用 target/debug/goog 或 cargo run --。执行前运行 goog auth list 记录活动账号,用户指定账号时传 --account EMAIL;不熟悉的命令先运行 --help。操作后通过 goog 回读资源,完成服务特定的视觉或结构检查,并返回资源 ID 与原生 Google URL。若提示缺少 scope,运行一次 goog auth login 后重试原命令。认证命令包括 goog auth setup、login、list、switch、export、mappings;导出的认证状态切勿提交,用毕删除。
限制与安全:每次实时变更都视为面向用户的工作;不得从浏览器顺序或记忆推断账号;优先使用高层命令而非原始 batch-update;不得用 || true 掩盖失败或在非零退出后报告成功;破坏性或共享操作前确认资源 ID;不得把实时文档、表格、消息、事件、账号或资源 URL/ID 提交到测试或仓库文档;临时请求体与验证产物放在任务本地暂存区;最终变更后重新读取实时资源;无法进行需认证的视觉检查时应报告视觉 QA 受阻。