Productivity Google Workspace:把 Gmail、Calendar、Drive 等操作收敛到 gws CLI 与 Python

前言

处理邮件、查日程、翻 Drive 里的文件,常见做法是开浏览器手动点,或者自己拼 Google API 的请求、处理 OAuth 刷新和分页。前者没法进脚本和自动化流程,后者要自己维护 token、权限范围和错误码。

下面介绍的 Skill 试图把这套操作收敛到一处:对外是 gws CLI,对内是 Python,覆盖 Gmail、Calendar、Drive、Docs、Sheets 五个 Google Workspace 组件。

这是什么

一个面向 office-efficiency 分类的 Agent Skill,坐标 @user_ef9e183a/productivity-google-workspace,由社区开发者 user_ef9e183a 发布并维护。

它要解决的问题是:让 Agent 或开发者在一个统一入口下完成 Google Workspace 的日常操作,而不是按产品逐个对接 API。

页面上的版本号是 1.0.0,来源标记为 community。

核心功能

官方简介只有一句:

Gmail, Calendar, Drive, Docs, Sheets via gws CLI or Python.

也就是说,能力范围限定在这五个组件,调用方式有两种:命令行的 gws,和 Python。页面标签里有一条 requires_api_key=true,说明使用前需要准备 Google API 凭据。

除此之外,已抓取资料没有列出更细的能力清单(支持哪些子命令、是否覆盖增量同步、权限范围具体到哪些 scope),这些需要在官方页面上再核对。本文不做推测。

安装与启用

这一项目前无法给出可用步骤。

已抓取的资料里只有名称、版本、来源、分类、发布者、评分和标签,没有安装命令、安装目录或配置文件字段。我两次抓取官方地址(https://api.skillhub.cn/user_ef9e183a/productivity-google-workspace 与 https://www.skillhub.cn/skills/user_ef9e183a/productivity-google-workspace)均失败,拿不到 README,因此不能写出命令行。

在拿到官方页面之前,这里只提示两点:

  1. 按标签 requires_api_key=true,启用前要先准备好 Google API key(或对应的 OAuth 凭据)。
  2. 通用 SKILL.md 格式的 Skill 通常通过 SkillHub 页面安装,具体入口以页面为准。

同样,Cursor、Codex CLI、Claude Code 三种环境在该 Skill 上是否有差异,资料中没有体现,不写。

典型用法

资料中没有可复现的调用示例,没有给出 gws 的子命令形态,也没有 Python 侧的函数签名。因此这一节留空,等待官方页面补齐后再填。

适用场景与注意

适合的场景,按简介可以推断为:

  1. 需要在脚本或 Agent 流程里收发 Gmail、读写日历、管理 Drive 文件。
  2. 已经把 Google Workspace 作为主要协作工具,希望把重复操作自动化。

限制与坑:

  1. 需要 API 凭据,涉及权限范围申请,属于额外成本。
  2. 页面标签 requires_api_key=true 已明确这一点,但它同时意味着凭据不能硬编码在仓库里。
  3. 版本为 1.0.0,社区发布,安装量为 0,遇到问题基本要靠自己读源码或在 SkillHub 上联系发布者。
  4. 能力边界取决于 Google API 本身,例如配额限制、审批流程和增量同步的复杂度,都会直接反映到 Skill 上。

小结

Productivity Google Workspace 的价值在于一个统一入口覆盖 Gmail、Calendar、Drive、Docs、Sheets,同时给 CLI 和 Python 两种调用方式,比逐个对接 Google API 少一层胶水。

目前资料能确认的只有定位、覆盖组件和「需要 API key」这一点。安装命令、用法示例都需要官方页面补充后才能落地,本文没有编造。

官方地址:https://www.skillhub.cn/skills/user_ef9e183a/productivity-google-workspace
接口地址:https://api.skillhub.cn/user_ef9e183a/productivity-google-workspace

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜