前言¶
在 Cursor、Claude Code 等环境里，如果要把 Gmail 检索、日历查询、Drive 搜索、Sheets 读写串进对话式工作流，常见做法是手写脚本或反复打开控制台 OAuth。每一步都要自己拼 API、管 token，Agent 也很难从项目里推断出「当前该用哪条命令」。
下面介绍 SkillHub 上的 gog（坐标 @user_dd2eef27/1t20260420021957）。它把开源工具 gogcli 的用法写进 SKILL.md，让模型在需要 Google Workspace 时按固定命令模板执行，而不是从零查文档。
这是什么¶
gog 的定位是：Google Workspace 的命令行入口，覆盖 Gmail、Calendar、Drive、Contacts、Sheets、Docs。
- 维护方：SkillHub 社区发布者
user_dd2eef27，来源标注为 community，当前版本 1.0.0。 - 底层依赖：本机需已安装名为
gog的可执行文件（Skill 元数据通过 Homebrew 公式steipete/tap/gogcli安装）；使用前需完成 Google OAuth，而非单纯填一个 API Key（SkillHub 标签requires_api_key=true表示需凭据，具体以 OAuth 流程为准）。 - 解决的问题：把「搜邮件、发信、查日程、搜 Drive、读改表格、导出文档」收敛到同一套 CLI，并通过 Skill 注入 Agent 的指令上下文。
核心功能¶
以下能力均来自该 Skill 自带的 SKILL.md 说明，对应 gog 子命令：
| 服务 | 能力概要 |
|---|---|
| Gmail | 搜索邮件、发送邮件 |
| Calendar | 按日历 ID 与 ISO 时间范围列出事件 |
| Drive | 按查询条件搜索文件 |
| Contacts | 列出联系人 |
| Sheets | 读取区间、更新/追加/清空单元格、读取元数据 |
| Docs | 导出为指定格式、在终端查看文档内容 |
文档中注明：Docs 支持 export / cat / copy；就地编辑文档需要 Docs API 客户端，gog 本身不提供。
安装与启用¶
安装分两层：先装 gog CLI 并完成授权，再把 Skill 装进当前 Agent 的 skills 目录。
1. 安装 gog CLI（本机）¶
Skill 元数据推荐的安装方式为 Homebrew：
brew install steipete/tap/gogcli
安装后确认命令可用：
command -v gog
2. OAuth 一次性配置¶
在 Google Cloud 控制台创建 OAuth 客户端并下载 client_secret.json 后，按 Skill 文档执行：
gog auth credentials /path/to/client_secret.json
gog auth add you@gmail.com --services gmail,calendar,drive,contacts,sheets,docs
gog auth list
将 you@gmail.com 换成你的 Google 账号。多账号场景可设置环境变量，避免每次加 --account：
export GOG_ACCOUNT=you@gmail.com
3. 通过 SkillHub 安装 Skill¶
若尚未安装 SkillHub CLI，可先按 SkillHub 安装说明 执行；已安装则直接安装本 Skill。必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 下，Agent 不会加载。
Cursor 示例：
skillhub install @user_dd2eef27/1t20260420021957 --dir ~/.cursor/skills/
Claude Code 可将目录改为 ~/.claude/skills/；Codex 可使用 ~/.codex/skills/ 或项目下的 .agents/skills/。各客户端路径以 SkillHub 安装文档 第四节为准。
SkillHub 页面也支持把下面这句发给 AI，由 Agent 按同一文档完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_dd2eef27/1t20260420021957`。
安装或更新 Skill 后，按你所用客户端的要求重启或刷新，使 SKILL.md 进入上下文。
典型用法¶
启用 Skill 后，Agent 应调用本机 gog，而不是臆造 HTTP 接口。下列示例可直接在终端复现（与 SKILL.md 一致）。
Gmail：搜索近 7 天邮件（最多 10 条）
gog gmail search 'newer_than:7d' --max 10
Gmail：发送邮件
gog gmail send --to a@b.com --subject "Hi" --body "Hello"
Calendar：列出时间范围内的事件
gog calendar events <calendarId> --from <iso> --to <iso>
Drive：搜索
gog drive search "query" --max 10
Contacts：列表
gog contacts list --max 20
Sheets：读取区间（JSON 输出）
gog sheets get <sheetId> "Tab!A1:D10" --json
Sheets：更新单元格
gog sheets update <sheetId> "Tab!A1:B2" --values-json '[["A","B"],["1","2"]]' --input USER_ENTERED
Docs：导出为纯文本
gog docs export <docId> --format txt --out /tmp/doc.txt
脚本化场景下，Skill 建议加上 --json 与 --no-input；Sheets 写入优先使用 --values-json 传二维数组。
适用场景与注意¶
适合谁
- 已在用 Google Workspace，希望 Agent 能「说人话、跑命令」完成邮件检索、日程查看、表格读写等办公动作。
- 愿意在本机维护 OAuth 凭据，并接受 CLI 而非纯网页操作。
限制与注意
- 环境前置：无
gog二进制或未gog auth时，Skill 只能提供命令说明，无法真正调用 API。 - 写操作需确认：
SKILL.md明确要求，发送邮件或创建日历事件前应经用户确认。 - Docs 编辑边界：导出与查看可用；复杂就地编辑需另接 Docs API 客户端。
- 社区 Skill：来源为 community，行为以安装的
SKILL.md与 gogcli.sh 为准；升级时可用skillhub对同一坐标更新。
SkillHub 展示页统计（截至页面抓取）：分类 office-efficiency，评分 100000，下载 855，安装 4；数据以 SkillHub 详情页 为准。
结尾¶
gog 把 Google Workspace 的常见操作压进一条 CLI，再通过 Skill 写进 Agent 的固定 playbook：OAuth 配一次，之后在对话里用搜索邮件、改表格、导出文档等任务即可对齐同一套命令。若你要在 Cursor 等环境里接 Gmail / Calendar / Drive / Sheets / Docs，可从 SkillHub 安装 @user_dd2eef27/1t20260420021957，并确保本机 gog 与授权已就绪。
- SkillHub 页面：https://www.skillhub.cn/skills/user_dd2eef27/1t20260420021957
- Skill 坐标 API：https://api.skillhub.cn/user_dd2eef27/1t20260420021957
- gog CLI 主页：https://gogcli.sh
