gws-meet

gws-meet skill 概覽

gws-meet 是 googleworkspace/cli 中專注於 Google Meet 的 skill，透過 gws CLI 來管理 Meet spaces 與會議相關產物。它最適合需要用 workflow agent 自動化 Meet 操作，而不是手寫 API 呼叫的使用者，尤其是你在意會議紀錄、錄影、逐字稿或 space 管理時。

這個 gws-meet skill 不是一個泛用的「聊聊 Meet」提示詞。它對應的是實際 API 資源，並且期待你提供結構化意圖：你要哪個資源、需要哪個 method，以及你能提供哪些識別碼或篩選條件。這讓它很適合用於 Workflow Automation，但前提是你能提供清楚的會議脈絡。

gws-meet 的用途

當工作內容是檢視或管理 Meet 資料時，就適合用 gws-meet，例如列出 conference records、抓取特定 record、處理參與者或錄影，或更新 meeting space。當你想要的是可重複的 gws-meet usage 流程，而不是臨時點選主控台，也很適合。

安裝前先確認哪些事

最大的採用門檻是環境是否就緒。gws-meet 依賴 gws binary，並且共用來自 ../gws-shared/SKILL.md 的驗證與安全規則。如果你的工作環境無法滿足這些前提，這個 skill 就不會可靠。

為什麼這個 skill 不一樣

gws-meet 的價值在於它與 API 對齊的結構：先找方法，再呼叫你真正需要的精確資源動作。這能減少猜測，但也表示這個 skill 最適合你已經知道目標物件是什麼的情況，例如 conference ID、meeting space 或日期範圍。

如何使用 gws-meet skill

安裝並驗證必要前提

在進行 gws-meet install 時，請使用 repository 的 skill 工作流程，並確認你的環境中已可使用 gws。接著在呼叫任何 Meet method 前先閱讀 ../gws-shared/SKILL.md，因為那個共用檔案定義了這個 skill 所繼承的驗證、全域 flags 與安全限制。

實際的安裝檢查方式，是先執行 Meet 介面的 CLI help，然後確認你的帳號具備你打算操作之資源所需的權限。

先從 skill entrypoint 開始

skill entrypoint 是 SKILL.md。先讀它，再依照它建議的方法探索流程往下做。對 gws-meet usage 來說，最重要的習慣就是在呼叫資源之前先檢查它們：

gws meet --help
gws meet <resource> --help
gws meet <resource> <method> --help

這樣可以避免把提示詞套到錯的資源上，或誤以為某個 method 存在，但其實不存在。

把模糊目標轉成好用的提示詞

一個好的 gws-meet 提示詞應該明確指出：

• 資源：conferenceRecords 或 spaces
• method：get、list、create、patch 或 endActiveConference
• 你已知的識別碼或篩選條件
• 你要的輸出，例如摘要、特定欄位集合，或後續動作

例如，不要只說「幫我查看 Google Meet 資料」，而應該像這樣要求：「使用 gws-meet 列出最近 7 天的 conference records，然後依開始時間與參與者人數摘要最新的 5 筆。」

先讀對檔案

這個 repository 的內容刻意保持精簡，因此最有訊號的閱讀順序是：

1. SKILL.md
2. ../gws-shared/SKILL.md
3. gws meet --help 的 CLI help

這個順序很重要，因為 skill 本體很短，而共用 skill 才包含實際執行時的規則。若跳過共用檔案，你可能會錯處理驗證或與安全相關的行為。

gws-meet skill 常見問答

gws-meet 只適合管理員嗎？

不是。gws-meet 對任何需要自動化 Meet 操作的授權使用者都有用，但存取權限仍取決於你的帳號權限與具體 API 資源。如果你在 Google Workspace 中無法讀取或修改某個會議物件，這個 skill 也不會幫你繞過限制。

我應該用 gws-meet，還是直接下普通提示詞？

當你想要可重複、由工具支援、假設較少的動作時，應該使用 gws-meet skill。普通提示詞適合發想，但 gws-meet 更適合需要精確選擇 API method、維持一致 CLI 用法、以及後續可延伸成自動化流程的工作。

最大的限制是什麼？

這個 skill 的範圍刻意做得很窄。它只聚焦在 Meet resources，並不提供廣泛的 workspace 管理。如果你的目標在同一輪流程中還牽涉 Calendar、Drive 或 Chat，gws-meet 只是整體 workflow 的其中一部分。

gws-meet 適合初學者嗎？

如果你已經知道要處理哪個會議物件，那它就算友善。不過如果你是從像「我所有會議發生了什麼事？」這種模糊問題開始，它就沒那麼適合入門，因為這個 skill 最適合搭配明確的資源名稱、ID 與日期範圍使用。

如何改善 gws-meet skill

一開始就給 agent 明確的 Meet 目標

要讓 gws-meet 的結果更好，最快的方法就是先提供具體目標：conference ID、meeting space、日期區間或篩選條件。像是「找出 team-sync 在週一到週五之間的最後一筆 conference record」會比「幫我查會議」有效得多。

一次只要求一個 API 形狀的工作

當每個請求都能清楚對應到一個 resource 和一個 method 時，這個 skill 的表現最好。如果你需要像 list → inspect → update 這樣的鏈式流程，請拆成多個步驟，讓工具能在往下走之前先驗證每個結果。

把輸出限制講清楚

請直接告訴 agent 你要原始 CLI 輸出、精簡摘要，還是要把欄位整理成表格。這可以減少來回確認，也能幫助 gws-meet 把焦點放在真正的工作流程上，而不是花時間決定呈現格式。

注意常見失敗模式

最常見的錯誤包括：缺少必要前提、資源選擇太模糊，以及假設某個 method 支援你尚未確認的資料。當第一次嘗試失敗時，下一次提示詞要補上精確的 gws meet <resource> <method> 形式、識別碼，以及日期或擁有範圍。