技能使用指南

gog（gogSkill）Skill 是什么？如何下载安装？

gogSkill（gog）是一个 Google Workspace 命令行技能，用一套 gog 命令统一管理 Gmail 邮件、Calendar 日历、Drive 云盘、Contacts 联系人、Sheets 表格与 Docs 文档。通过 Homebrew 一键安装、OAuth 一次授权，即可在终端与 AI 工作流中搜索邮件、发送纯文本或 HTML 邮件、创建带颜色的日程、读写表格数据、导出文档。配合 --json 与 --no-input 参数可无缝接入自动化流程，让开发者与效率用户告别网页反复点击，把重复办公操作变成可复用的命令。

gogSkillgog
8 个章节 约 16 分钟阅读 AI 智能生成

gogSkill：用一条命令统一管理 Gmail、日历、云盘、联系人与文档

  • 一个技能覆盖六大服务：gogSkill（英文名 gog）把 Gmail、Calendar、Drive、Contacts、Sheets、Docs 全部收进同一个命令行入口，不用在六个网页标签之间来回切换。
  • 终端里的 Google Workspace：搜索邮件、发信、建日程、查文档、读写表格，全部用 gog 子命令完成，天然适合写进脚本和自动化流程。
  • 为自动化与 AI 工作流而生：支持 --json 与 --no-input 参数，输出可直接被程序解析，是让 AI 助手"真的动手操作邮箱和日历"的关键一环。
  • 安装门槛低，授权一次到位：通过 Homebrew 安装，OAuth 凭据配置与账号授权各有专门命令，配置一次即可长期复用。
  • 能力边界要清楚：支持 Docs 的导出、查看、复制，但原地编辑需要 Docs API 客户端，不在本技能范围内。

该技能叫什么？如何下载安装 AI 技能提升开发效率？

这个技能的中文名是 gogSkill，英文名 gog，技能 ID 为 13589。它的官方主页为 https://gogcli.sh （更多资料以官方说明为准）。

它要解决的问题非常具体：Google Workspace 的能力很强，但操作入口都在浏览器里。想批量搜索一周内的邮件、想按脚本给客户群发通知、想让 AI 助手自动把会议记要写进表格、想把一份 Google 文档导出成纯文本做检索——这些事在网页上手动操作既慢又无法复用。gog 把这些动作收敛成一组结构化的命令行指令，让"人点鼠标"变成"机器跑命令"。

为什么强调"一键安装"？ 因为 AI 技能真正的价值不在于"能不能做"，而在于"接入要多久"。gogSkill 的安装链路被压缩到了极短的三步：

第一步：确认安装前提。

  • 一台可以运行 Homebrew 的 macOS / Linux 环境（安装方式以 Homebrew 生态为准，其他平台请参考官方说明）。
  • 一个 Google 账号，以及一个可用的 OAuth 客户端凭据文件 client_secret.json（需在 Google 侧自行申请，具体路径与权限范围以 Google 官方说明为准）。
  • 准备好要授权的服务范围：gmail、calendar、drive、contacts、docs、sheets。

第二步：通过 Homebrew 安装。 技能详情中给出的安装方式为 brew，formula 名为 steipete/tap/gogcli，安装后可执行文件为 gog，安装标识为「安装 gog (brew)」。因此安装动作本质上就是一条 brew 安装命令，例如：

brew install steipete/tap/gogcli

安装完成后，终端里应当能识别 gog 这个命令。

第三步：完成一次性 OAuth 授权。 这是整个过程中唯一"有仪式感"的部分，但只需做一次：

gog auth credentials /path/to/client_secret.json
gog auth add you@gmail.com --services gmail,calendar,drive,contacts,docs,sheets
gog auth list

三条命令分别对应：登记客户端凭据、把某个 Gmail 账号按指定服务范围加入、列出当前已授权的账号。

第四步：验证是否生效。 最轻量的验证方式是执行 gog auth list 确认账号出现在列表里；随后可以用 gog gmail search 'newer_than:7d' --max 10 或 gog contacts list --max 20 做一次真实调用，能正常返回结果即说明链路打通。为了减少重复输入账号，还可以设置环境变量 GOG_ACCOUNT=you@gmail.com。

该技能的主要功能和特点

  • 六大服务统一入口：Gmail、Calendar、Drive、Contacts、Sheets、Docs 各自拥有独立子命令族，命名风格一致（如 gog gmail ...、gog calendar ...、gog sheets ...），学习一次即可迁移。
  • 两种邮件搜索粒度：gog gmail search 按线程返回，每个线程一行；gog gmail messages search 按单封邮件返回，适合需要逐封处理的场景（例如 in:inbox from:ryanair.com）。
  • 发信方式极其灵活：支持内联纯文本 --body、多行文件 --body-file、标准输入 --body-file -、富文本 --body-html，并支持发草稿、发已有草稿、以及带 --reply-to-message-id 的回复。
  • 日历不只是增删改：支持列出事件（--from / --to 指定时间区间）、创建事件、更新事件，还支持用 --event-color 给事件上色，颜色 ID 1-11 可通过 gog calendar colors 查看（如 7 为 #46d6db、4 为 #ff887c、11 为 #dc2127）。
  • 表格支持完整读写链路：get 读取区间、update 覆盖写入、append 追加行、clear 清空区域、metadata 查看结构，并支持 USER_ENTERED / INSERT_ROWS 等写入语义。
  • 文档支持导出与速览：gog docs export 可导出为 txt 等格式并落盘，gog docs cat 直接在终端查看内容，适合做内容检索与二次加工。
  • 对脚本与 AI 友好：官方备注推荐脚本场景使用 --json 加 --no-input，把结果变成结构化数据而非人眼可读文本；这正是它区别于"人类向 CLI"的关键差异。

和普通工具相比，它强在边界统一：不必为邮件学一套 SDK、为表格学一套 SDK、为日历再学一套，一套命令风格覆盖全程。

如何使用该技能？

步骤 1：完成安装与授权。 按上一节完成 brew 安装、凭据登记与账号授权，并用 gog auth list 确认。

步骤 2：确定当前账号。 单账号场景可直接使用；多账号场景在命令后追加 --account you@example.com，或全局设置 GOG_ACCOUNT。

步骤 3：读数据——先用搜索类命令探路。

gog gmail search 'newer_than:7d' --max 10
gog gmail messages search "in:inbox from:ryanair.com" --max 20 --account you@example.com
gog drive search "季度报告" --max 10
gog calendar events <calendarId> --from <iso> --to <iso>

输入为查询语句与数量上限，输出为该线程/邮件/文件/事件的列表。

步骤 4：写数据——发邮件、建日程、写表格。

发送一封纯文本邮件（单行）：

gog gmail send --to a@b.com --subject "Hi" --body "Hello"

发送多段落邮件，推荐用标准输入避免转义问题：

gog gmail send --to recipient@example.com \
  --subject "Meeting Follow-up" \
  --body-file - <<'EOF'
Hi Name,

Thanks for meeting today. Next steps:
- Item one
- Item two

Best regards,
Your Name
EOF

创建日程并指定颜色：

gog calendar create <calendarId> --summary "Title" --from <iso> --to <iso> --event-color 7

写入表格（推荐 --values-json）：

gog sheets update <sheetId> "Tab!A1:B2" --values-json '[["A","B"],["1","2"]]' --input USER_ENTERED
gog sheets append <sheetId> "Tab!A:C" --values-json '[["x","y","z"]]' --insert INSERT_ROWS

步骤 5：处理输出。 面向脚本时加 --json 让结果结构化；面向人工阅读时保留默认输出即可。文档类内容可用 gog docs export <docId> --format txt --out /tmp/doc.txt 落盘后再交给其他工具。

步骤 6：注意两个高频坑。 其一，--body 不会把 转义为换行，需要内联换行时请用 heredoc 或 `$'Line 1

Line 2’` 写法；其二，发送邮件或创建事件前请人工确认目标与内容，避免批量操作误伤。

同类型竞品对比分析

方案名称 定位 核心功能 安装/使用门槛 适用场景 优势与不足
gogSkill（gog） 面向开发者与自动化的 Google Workspace 命令行 Gmail、Calendar、Drive、Contacts、Sheets、Docs 六大服务统一 CLI，支持 JSON 输出 Homebrew 一条命令安装，OAuth 一次授权 脚本批处理、AI 助手调用、终端化日常办公 优势：统一入口、命令风格一致、原生适配自动化；不足：Docs 不支持原地编辑，富文本能力有限
官方 API 客户端库自行开发 平台原生的最高自由度方案 覆盖全部 Google Workspace 接口能力 需自行处理鉴权、分页、重试、错误处理 有研发投入、需求高度定制的团队 优势：能力最全、可控性最高；不足：开发成本高，需要长期维护鉴权与版本变更
Zapier / Make 等自动化平台 无代码连接器 以触发器 + 动作的方式连接 Gmail、Sheets 等 网页配置，几乎无技术门槛 市场、运营人员的轻量自动化 优势：上手最快、无需环境；不足：复杂逻辑受限，按任务量计费，难以嵌入自有 CLI 工作流
浏览器手工操作 / 网页版 最通用的默认方式 全部功能以 UI 呈现 零门槛 一次性、低频、需要人工判断的操作 优势：直观、无配置；不足：无法批量、无法复用、无法被程序与 AI 调用

该技能的典型应用场景与实际体验情况

场景一：独立开发者 / 技术负责人的"每日巡检"。 痛点：每天要确认是否有关键客户邮件、是否遗漏会议、上周的报告是否已上传。使用方式：把 gog gmail messages search "in:inbox from:重要客户域名" --max 20、gog calendar events ... 组合进一个 shell 脚本，早上跑一次输出摘要。实际体验：命令语义直白，参数记忆成本低；但多个命令的组合逻辑仍需自己写，建议从三条命令起步逐步扩展。

场景二：AI 助手的"手脚"。 痛点：AI 能写邮件草稿，但无法真正发出去、无法把结果写进表格。使用方式：让助手调用 gog gmail drafts create 生成草稿供人工审核，审核后 gog gmail drafts send <draftId> 发出；结构化数据则通过 gog sheets append 追加成行。实际体验：--json 与 --no-input 是为这类场景准备的关键开关，加上之后调用稳定很多；务必保留人工确认环节。

场景三：运营 / 行政的批量事务。 痛点：几十场活动的日程需要逐个创建，颜色还要区分类型。使用方式：写一份含标题与时间区间的清单，循环调用 gog calendar create 并配合 --event-color（如培训用 7、评审用 4）。实际体验：一次配置、多次复用，收益随批量规模线性放大；注意时间参数需使用 ISO 格式，建议先小批量试跑。

场景四：内容 / 数据同学的文档取用。 痛点：资料散落在 Docs 与 Sheets 中，想统一导出后做检索或喂给模型。使用方式：gog docs export <docId> --format txt --out /tmp/doc.txt 批量落盘，再用 gog sheets get <sheetId> "Tab!A1:D10" --json 抽取表格数据。实际体验：导出与读取非常顺滑；但需要提前明确"只读"定位——Docs 的原地编辑不在本技能能力范围内。

整体上手难度：中等偏低。真正的门槛集中在 OAuth 凭据准备这一步，一旦跨过，后续几乎全是"照抄命令改参数"。

该技能能为用户带来的价值

  • 把"点击"变成"可复用资产"：网页上的每一次操作都是一次性的，而一条 gog 命令可以被写进脚本、融进流水线、交给 AI 反复执行。一次投入，长期复用。
  • 显著压缩重复劳动：批量创建日程、批量追加表格行、按条件筛选邮件——这类原本按"分钟 × 次数"累积的工作，改为一条命令后基本归零。
  • 降低自动化门槛：不必先啃通 Google 各服务的 SDK 与鉴权体系，OAuth 三条命令 + 六个子命令族即可开始产出。
  • 打通 AI 与真实办公系统的最后一公里：有了 --json 输出与 --no-input 输入，AI 助手从"只会说"变成"能真正读写邮箱、日历与表格"。
  • 长期价值在于一致性：所有服务共享同一套命令风格与环境变量（如 GOG_ACCOUNT），团队内部沉淀的脚本与提示词可以在成员之间直接复用。

常见问题 FAQ

Q1：安装后提示找不到 gog 命令怎么办？ 先确认 Homebrew 安装已成功完成（formula 为 steipete/tap/gogcli，可执行文件名为 gog），再检查当前终端的 PATH 是否包含 Homebrew 的安装路径。若仍无法识别，请以官方主页 https://gogcli.sh 的说明为准进行排查。

Q2：这个技能收费吗？ 技能本身是一个通过 Homebrew 分发的命令行工具，其费用与授权方式以官方说明为准；需要注意的另一方面是 Google 侧的接口配额与账号权限，同样以 Google 官方说明为准。

Q3：可以同时管理多个 Google 账号吗？ 可以。通过 gog auth add 可以添加多个账号，之后在命令中使用 --account you@example.com 指定；如果长期只用某一个账号，设置环境变量 GOG_ACCOUNT 即可免去重复输入。用 gog auth list 随时查看已授权清单。

Q4：能直接修改 Google 文档的正文吗？ 不能。gog 对 Docs 的支持集中在导出、查看（gog docs cat）与复制，原地编辑需要 Docs API 客户端，不在 gog 的能力范围内。如果你的需求是"读文档、改文档内容再写回"，需要另配工具。

Q5：邮件正文里的 为什么没换行？ 这是设计如此——--body 不会对 做转义。需要多段落时请使用 --body-file ./message.txt、--body-file - 配合 heredoc，或 `$'Line 1

Line 2’写法；只有在确实需要富格式时，才使用–body-html并配合<p>、<br>、<strong>` 等标签。