gws-workflow

gws-workflow 技能總覽

gws-workflow 的用途

gws-workflow 技能是 gws CLI 的 Google Workspace 自動化層。它可以幫你執行跨服務工作流程，例如會議準備、站立會摘要、把 email 轉成任務、以及從 Drive 發出 Chat 公告，而不必先靠猜測原始 API 的資料結構。

誰適合安裝

如果你已經在使用 gws，而且想要的是可重複執行的營運流程，而不是一次性的提示詞，建議安裝 gws-workflow。對於需要把 Gmail、Calendar、Tasks、Drive 和 Chat 串成單一成果的代理程式來說，這個技能很合適。

它的不同之處

gws-workflow 技能的核心價值，在於它會先引導你如何搜尋指令、正確塑形輸入，再進入執行。這一點很重要，因為工作流程失敗通常不是出在核心任務本身，而是缺少參數、資源與方法配對錯誤，或是跳過了 schema 步驟。

如何使用 gws-workflow 技能

安裝與前置設定

執行 gws-workflow install 時，請使用 CLI 的技能安裝流程，並先確認共用的 auth layer 已經就緒。這個技能明確依賴 ../gws-shared/SKILL.md；如果它不存在，先執行 gws generate-skills，讓 auth、全域 flags 和 security rules 在你開始呼叫 workflow 之前都先可用。

先從檢查指令開始

最有效率的 gws-workflow usage 流程是：先讀 SKILL.md，再執行 gws workflow --help，最後用 gws schema workflow.<resource>.<method> 檢查目標方法。這是建構 --params 或 --json 之前，找出必填參數、型別與預設值最安全的方法。

把模糊目標轉成可用提示詞

像「幫我準備會議」這種較弱的請求，如果你把 resource、期望輸出與限制說清楚，技能會更容易執行，例如：「使用 gws workflow calendar.events list 和相關方法，為明天的 1:1 準備會議簡報，包含與會者、議程背景和關聯文件。」你的目標越具體，代理程式就越不容易挑錯 helper command。

先讀這些檔案

先從 SKILL.md 開始，接著在你的任務符合其中某個內建 workflow 時，沿著 skills/gws-workflow-* 底下連結的 helper commands 往下讀。實務上，這表示你應該先閱讀最接近你要完成工作的 helper skill，再嘗試從頂層指南自行推演。

gws-workflow 技能 FAQ

gws-workflow 只適合進階使用者嗎？

不是。就算你不熟 Google Workspace APIs，這個技能仍然很有用，因為它會教你如何搜尋指令與檢查 schemas，而不是直接假設欄位名稱。初學者如果照著 schema 步驟走，通常受益最大，而不是憑感覺拼參數。

什麼情況下不該用 gws-workflow？

如果你只需要一段白話摘要，或只是想要一個沒有任何實際 Workspace 動作的人工回覆，就不該用它。若你的任務不需要執行 gws 指令，這個技能只會增加不必要的負擔。

它和一般提示詞有什麼不同？

一般提示詞可以描述結果，但 gws-workflow 是以可執行的 workflow 探索為核心。當你需要可重現的 gws workflow 呼叫時，它更適合，尤其是在多個 Google 服務之間協作、而且正確的方法與 flags 會影響結果時。

它是否適用於更廣泛的 gws-workflow Workflow Automation 情境？

可以，但前提是自動化必須建立在受支援的 gws resources 和 methods 上。如果你的 workflow 需要超出 Google Workspace APIs 以外的自訂業務邏輯，仍然得搭配外部 scripting 或 orchestration。

如何改進 gws-workflow 技能

先提供精確的 workflow 目標

最好的 gws-workflow 結果，來自一開始就直接點出 service、resource 和想要的結果：像是「明天客戶電話會議的 Calendar event 查詢」就比「幫我處理行事曆」好得多。這樣能縮小指令搜尋範圍，也更容易讓第一版輸出就能直接使用。

把你需要的輸出格式說清楚

請明確說你要的是摘要、任務、草稿訊息，還是結構化的 command invocation。例如，「回傳一份 standup summary，包含 meetings、open tasks 和 blockers」會比「分析我的一天」給 helper 更清楚的目標。

在執行前先驗證 schema

常見失敗模式，是誤以為某個 method 會接受和另一個 Google API 相同的欄位。只要輸入格式不明，就應該每次都用 gws schema workflow.<resource>.<method>，尤其是在處理 --params 和 --json 時；這能減少重試，也能避免沒有明顯錯誤但實際上不匹配的情況。

從 helper workflows 迭代，不要從零開始

如果第一次嘗試太寬泛，就改用最接近的 helper command，例如 +meeting-prep 或 +email-to-task，再從那裡逐步收斂。這些路徑通常比自己發明新提示詞更有效，因為它們更直接地編碼了 workflow 意圖。