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

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

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

小夜