前言¶
處理郵件、查日程、翻 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,因此不能寫出命令行。
在拿到官方頁面之前,這裏只提示兩點:
- 按標籤
requires_api_key=true,啓用前要先準備好 Google API key(或對應的 OAuth 憑據)。 - 通用 SKILL.md 格式的 Skill 通常通過 SkillHub 頁面安裝,具體入口以頁面爲準。
同樣,Cursor、Codex CLI、Claude Code 三種環境在該 Skill 上是否有差異,資料中沒有體現,不寫。
典型用法¶
資料中沒有可復現的調用示例,沒有給出 gws 的子命令形態,也沒有 Python 側的函數簽名。因此這一節留空,等待官方頁面補齊後再填。
適用場景與注意¶
適合的場景,按簡介可以推斷爲:
- 需要在腳本或 Agent 流程裏收發 Gmail、讀寫日曆、管理 Drive 文件。
- 已經把 Google Workspace 作爲主要協作工具,希望把重複操作自動化。
限制與坑:
- 需要 API 憑據,涉及權限範圍申請,屬於額外成本。
- 頁面標籤
requires_api_key=true已明確這一點,但它同時意味着憑據不能硬編碼在倉庫裏。 - 版本爲 1.0.0,社區發佈,安裝量爲 0,遇到問題基本要靠自己讀源碼或在 SkillHub 上聯繫發佈者。
- 能力邊界取決於 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