gws-calendar skill 是什麼、怎麼安裝使用：讓智能體用命令行查看和創建 Google 日曆日程

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

這個 Skill 做什麼

description：Google Calendar——管理日曆和日程。它是 gws 命令行日曆部分的索引，篇幅不長（四千多字符），結構和同系列技能一致。

• 輔助命令兩個：+agenda 顯示所有日曆上即將到來的日程；+insert 新建一個日程。
• 接口資源：events（日程的增刪改查、移動、快速添加等）、calendars（日曆本身）、calendarList（你的日曆列表）、freebusy（忙閒查詢）、acl（日曆的訪問控制規則）、settings、colors、channels（變更通知）。
• 發現命令：gws calendar --help 看資源和方法，gws schema calendar.<資源>.<方法> 看參數。

有一個方法值得特別小心：calendars 下的 clear 會清空主日曆，SKILL.md 的說明寫得很直白——這個操作會刪除帳戶主日曆上的全部日程。公共技能 gws-shared 的安全規則在這裏很有必要：執行寫入或刪除命令前必須向用戶確認，破壞性操作優先加 --dry-run。

倉庫裏還有幾個圍繞日曆的「配方」技能，如找共同空閒時間、安排每週日程、改期會議、預留專注時間，以及一個把「會前準備」串起來的工作流技能，可以和這個基礎技能一起裝。

怎麼安裝

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

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

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

怎麼用

• 「我今天和明天有哪些安排？」——對應 +agenda。
• 「週五下午三點建一個一小時的日程，標題是季度復盤，邀請這兩個電郵」。
• 「查一下我和這三位同事下週共同的空閒時段」——走 freebusy 查詢。

適合誰 / 侷限

適合用 Google 日曆、想讓智能體代為查詢和排期的人。侷限：只有兩個封裝好的快捷命令，其他操作要智能體自己拼接口參數；時區、重複日程這些細節容易出錯，重要日程建好後自己看一眼；首次使用需要配置 Google Cloud 項目和 OAuth。

注意事項

• 許可：Apache-2.0；README 聲明非 Google 官方支持產品。
• 創建日程會向受邀人發送邀請，執行前確認時間和人員。
• 刪除與清空操作不可恢復，尤其是 clear。
• 日程裏的會議連結、參會人電郵會進入模型上下文。