gws-gmail skill 是什麼、怎麼安裝使用：讓 Claude Code、Gemini CLI 用命令行收發和整理 Gmail

本文根據 googleworkspace/cli 倉庫裏該技能的 SKILL.md 與倉庫 README 整理，資料核對於 2026-10-11。skills.sh 榜單當日顯示該技能累計安裝約 7.9 萬次；所在倉庫 googleworkspace/cli 在 GitHub 約 3.1 萬 Star（同日數據）。技能內容會隨倉庫更新，以倉庫為準。

這個 Skill 做什麼

gws 是一個把 Google Workspace 各項服務接口包成命令行的工具，它的技能大多很薄：告訴智能體有哪些命令、怎麼查參數，具體細節讓智能體運行時自己用 --help 去查。gws-gmail 就是這樣一份 Gmail 的索引。description 只有一句：Gmail——發送、閱讀和管理電郵。

SKILL.md 分三塊：

• 輔助命令（+ 開頭，是對常見動作的封裝，各自還有一個同名的小技能）：+triage 顯示未讀收件箱摘要（發件人、主題、日期）；+read 讀取一封電郵並提取正文或電郵頭；+send 發信；+reply、+reply-all 回覆並自動處理會話歸屬；+forward 轉發；+watch 監聽新電郵並以逐行 JSON 的形式流式輸出。
• 接口資源：users 下的草稿、歷史記錄、標籤、電郵、設定、會話等，對應 Gmail 接口的原生方法。
• 發現命令：調用任何接口方法之前，先用 gws gmail --help 瀏覽資源和方法，再用 gws schema gmail.<資源>.<方法> 查看必填參數、類型和預設值。

開頭的前置要求是先讀公共技能 gws-shared，那裏有認證方式、全局參數和三條安全規則：不直接輸出密鑰和令牌；執行寫入或刪除命令前必須向用戶確認；破壞性操作優先用 --dry-run 先在本地校驗。

怎麼安裝

技能只是說明書，真正幹活的是命令行工具 gws，所以要裝兩樣（命令來自倉庫 README）：

bash
npm install -g @googleworkspace/cli
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-gmail

第二條是 README 給出的「只裝某一個技能」的寫法；SKILL.md 開頭要求同時讀取 gws-shared（認證、全局參數和安全規則），缺了它可以運行 gws generate-skills 生成。之後執行 gws auth setup 和 gws auth login 完成 Google 帳號授權。Gemini CLI 用戶可以直接 gemini extensions install https://github.com/googleworkspace/cli。

倉庫整體介紹和其他安裝方式，詳見本站《gws 是什麼、怎麼安裝使用：Google Workspace 命令行工具與 Agent Skills（讓智能體操作 Gmail、Drive、日曆、表格）》。

怎麼用

• 「看一下我的未讀電郵，按重要程度排個序」——對應 +triage。
• 「讀一下張三昨天那封關於報價的電郵，起草一份回覆，先別發」。
• 「把帶『發票』標籤的電郵列出來，整理成表格」。

發信、回覆、轉發這些動作，建議始終讓它先把收件人和正文給你過目。

適合誰 / 侷限

適合用 Google Workspace 辦公、想把電郵處理接進智能體工作流的人。侷限：需要自己有一個 Google Cloud 項目來配置 OAuth 憑據，首次設定有門檻；技能本身資訊量小，複雜操作依賴智能體現場查參數，偶爾要多試幾次；國內網絡訪問 Google 服務受限。

注意事項

• 許可：Apache-2.0。倉庫 README 聲明這不是 Google 官方支持的產品。
• 電郵內容會進入模型上下文：電郵裏的驗證碼、合同、個人資料都在其中，授權範圍越小越好，登入時只勾選需要的權限。
• 電郵正文是不可信輸入：別人發來的電郵裏可能夾帶誘導智能體執行操作的文字，不要讓它在無人確認的情況下自動回覆或轉發。
• 會以你的身份真實發信，發出後無法撤回。