前言¶
日常开发里，Gmail、日历、Drive、通讯录、Sheets、Docs 往往分散在网页或各自 SDK 里。你要查邮件、改日程、找文件，常常要在浏览器和代码之间来回切换，或者为每个产品单独接 OAuth 和 API。若希望对话式 Agent 能按你的意图直接操作这些服务，需要一套可被 Skill 调用的统一入口。
下面介绍 SkillHub 上的 gog3（坐标 @user_dd2eef27/1t20260420021952，当前版本 1.0.2）。它定位为 Google Workspace CLI，覆盖 Gmail、Calendar、Drive、Contacts、Sheets 与 Docs，由社区发布者 user_dd2eef27 维护，分类为 dev-programming。
这是什么¶
gog3 是一则基于通用 SKILL.md 格式的 Agent Skill，核心价值是把 Google Workspace 常见能力收敛到命令行/脚本层面，供 Cursor、Claude Code、Codex 等支持 Skills 的客户端在对话中调用。
SkillHub 页面上的简介为：
Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs.
来源标注为 community（社区技能，非平台官方出品）。安装包标签包含 requires_api_key=true，表示使用前需要配置与 Google API 相关的密钥或凭证；具体字段名与 OAuth 流程以安装后目录内的 SKILL.md 为准，本文不展开未在公开页面出现的配置项。
核心功能¶
根据 SkillHub 已公开信息，gog3 覆盖以下 Google Workspace 产品线（通过 CLI 形态暴露，由 Agent 按 Skill 说明执行）：
- Gmail：与邮件相关的 CLI 操作（具体子命令见安装后的 SKILL.md）。
- Calendar：日历相关操作。
- Drive：云盘文件与目录相关操作。
- Contacts：通讯录相关操作。
- Sheets：电子表格相关操作。
- Docs：文档相关操作。
公开资料未列出逐条子命令或 REST 路径；启用 Skill 后，Agent 会读取本地 SKILL.md 与附带脚本/说明来组织调用。请勿在未安装技能的情况下臆造命令行示例。
安装与启用¶
1、安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 skillhub：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅需 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装 gog3 到当前 Agent 的 skills 目录¶
安装技能时必须使用 --dir 指向当前客户端识别的 skills 目录，否则默认会装到 ./skills/，Agent 可能无法加载。SkillHub 页面给出的安装提示为：依据 SkillHub 安装说明 安装坐标 @user_dd2eef27/1t20260420021952。
命令行方式示例（将 <skills 目录> 换成你当前环境的路径）：
skillhub install @user_dd2eef27/1t20260420021952 --dir <skills 目录>
常用客户端的 skills 目录（摘自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可在 SkillHub 技能页把「安装提示词」发给 AI，让其按同一坐标完成安装；本质仍是拉取 @user_dd2eef27/1t20260420021952 到正确的 skills 目录。
3、API 密钥与 Google 访问¶
标签 requires_api_key=true 表明该 Skill 依赖 API 密钥或 Google 侧凭证。公开页面未列出环境变量名或配置文件路径；安装完成后请打开技能目录中的 SKILL.md，按其中要求配置 Google Cloud 项目、OAuth 或 Service Account 等（以技能作者文档为准）。
典型用法¶
公开 SkillHub 详情页未附带可复制的 CLI 示例。经过上面的安装步骤后，典型工作流是：
- 在对话中说明目标（例如处理邮件、查询日程、在 Drive 中定位文件、读写 Sheets 等）。
- Agent 根据 gog3 的 SKILL.md 选择对应 Google Workspace 产品的 CLI 调用方式。
- 在已配置 API 密钥与 Google 授权的前提下执行命令，并将结果返回对话。
若需要确认某条命令是否属于本 Skill，应在本地技能包内检索 SKILL.md 与附带的 scripts/（若存在），而不是引用第三方仓库中同名但无关的 CLI 工具。
适用场景与注意¶
适合谁
- 已在用 Cursor、Claude Code、Codex 等，并希望 Agent 能操作 Google Workspace 六类产品的开发者。
- 愿意自行完成 Google API 项目创建、密钥管理与 OAuth 授权的团队。
限制与注意
- 社区来源：维护节奏与 Google API 变更同步取决于发布者，升级前可用
skillhub查看是否有新版本（当前公开版本为 1.0.2）。 - 凭证敏感：
requires_api_key=true；勿将密钥提交到仓库，按 SKILL.md 使用环境变量或本地配置。 - 合规与配额：调用 Gmail、Drive 等接口需遵守 Google API 使用条款与配额；生产环境建议单独审计权限范围。
- 平台数据：SkillHub 页面显示评分 100000、下载 710（统计随平台更新，以技能页为准）。
结尾¶
gog3 把 Google Workspace 的 Gmail、Calendar、Drive、Contacts、Sheets、Docs 收敛为可供 Agent 调用的 CLI Skill，适合在对话里完成办公自动化，而无需为每个产品单独写集成胶水代码。安装时记住坐标 @user_dd2eef27/1t20260420021952，并把包装进当前客户端的 skills 目录。
- SkillHub 技能页：https://www.skillhub.cn/skills/user_dd2eef27/1t20260420021952
- 官方 API 坐标页：https://api.skillhub.cn/user_dd2eef27/1t20260420021952
- 安装说明：https://skillhub.cn/install/skillhub.md
