gws-drive skill 是什麼、怎麼安裝使用：讓智能體用命令行管理 Google Drive 文件、權限和共享雲端硬碟

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

這個 Skill 做什麼

gws-drive 是 gws 命令行裏 Google Drive 那一部分的說明書。description：Google Drive——管理文件、文件夾和共享雲端硬碟。和 gws 的其他技能一樣，它不講操作流程，主要是一份「有哪些資源、每個資源有哪些方法」的清單，一萬三千多字符裏絕大部分是接口方法的逐條說明。

內容結構：

• 輔助命令只有一個：+upload，上載文件並自動填好元數據。
• 接口資源十幾類：files（文件與文件夾的創建、複製、導出、列出、更新、刪除等）、permissions（誰能訪問）、comments 與 replies（評論和回覆）、revisions（修訂版本）、drives（共享雲端硬碟）、changes（變更記錄）、accessproposals（訪問申請的查看與審批）、approvals、about（帳戶與容量資訊）等。每個方法帶一句說明，不少還附了 Google 開發者文檔的連結。
• 發現命令：先 gws drive --help 瀏覽，再用 gws schema drive.<資源>.<方法> 看參數。

通用的調用格式在公共技能 gws-shared 裏：gws <服務> <資源> <方法>，查詢參數用 --params 傳 JSON，請求體用 --json，下載用 -o 指定儲存路徑，--page-all 自動翻頁。那裏的安全規則同樣適用：寫入和刪除前先確認，破壞性操作優先 --dry-run。

怎麼安裝

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

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

第二條是 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、日曆、表格）》。

怎麼用

• 「列出我雲端硬碟裏最近一週修改過的文檔」。
• 「把 report.pdf 上載到『季度彙報』文件夾」——對應 +upload。
• 「查一下這個文件夾對外共享給了哪些人，列成表，先不要改權限」。

倉庫裏另有一批以 recipe- 開頭的「配方」技能，把常見任務寫成了現成步驟，例如找出佔空間的大文件、批量下載文件夾、整理文件夾，可以按需加裝。

適合誰 / 侷限

適合要批量整理 Drive、做權限盤點或把文件操作寫進自動化流程的人。侷限：技能只是接口索引，「先查什麼再改什麼」要靠你的指令和智能體自己摸索；Drive 的搜尋語法和字段選擇有學習成本；需要自備 Google Cloud 項目完成 OAuth 配置。

注意事項

• 許可：Apache-2.0；README 聲明非 Google 官方支持產品。
• 權限與刪除操作影響他人：改共享設定、刪除文件這類動作務必先看它打算執行的命令。
• 文件內容和文件名會進入模型上下文，授權時只給需要的範圍。
• 上載的是本機文件，確認路徑無誤。