gws-slides

gws-slides 技能概覽

gws-slides 是 googleworkspace/cli 裡的 Google Slides 技能，透過 gws CLI 來讀取與寫入簡報。它最適合需要檢查投影片、建立簡報，或在不手動進瀏覽器編輯 Slides 的情況下做結構化修改的代理程式。如果你的工作是「根據提示安全地更新這份簡報」，gws-slides 就是正確的起點。

gws-slides 技能的核心價值，在於它把 Slides API 放進以命令為導向的工作流程，而不是假設一般提示詞就能猜對正確的請求格式。這一點很重要，因為簡報更新常常對結構很敏感：標題、ID、頁面資源與批次操作都需要有效參數，否則整個操作就可能失敗。這個技能也把前置條件講得很清楚：你必須先完成共享的 gws-shared 設定，才能有驗證、全域旗標與安全規則。

gws-slides 的用途

當你需要有 API 支援的動作，例如建立簡報、抓取目前狀態，或對頁面與其他簡報資源套用批次更新時，就使用 gws-slides 來處理 Slide Decks。它比起一次性的文案撰寫，更適合自動化、可重複的編輯流程，以及由代理程式驅動的維護工作。

什麼情況下適合使用

如果你已經確定要在 Google Workspace CLI 生態系裡工作，而且你能提供具體的 deck ID、標題或編輯目標，那就選 gws-slides 技能。當你需要的是可預測、可重現的變更，而不只是對投影片內容的建議時，它會是很強的選擇。

主要限制先知道

這個技能本身不是一套「從零設計簡報」的系統。你仍然需要把目標轉成有效的 Slides API 請求，而且只要不是最基本的探索，就應該預期先檢查 method schema 再動手。如果你要的是視覺版面策略，而不是 API 執行，泛用式提示詞可能會更容易上手。

gws-slides 技能的使用方式

正確安裝 gws-slides

安裝 gws-slides 時，請使用 repository 的 CLI 套件流程：npx skills add googleworkspace/cli --skill gws-slides。安裝完成後，確認 SKILL.md 裡提到的前置條件：必須存在 ../gws-shared/SKILL.md，才能進行驗證與共享規則處理。如果缺少這個檔案，repo 會指示你執行 gws generate-skills。

先讀對的檔案

先從 skills/gws-slides/SKILL.md 開始，再讀它引用的共享技能檔。最快的閱讀順序是：

1. SKILL.md，看命令格式與資源清單。
2. ../gws-shared/SKILL.md，看驗證與安全限制。
3. gws slides --help，確認可用資源與方法。
4. 在真正建立請求前，先跑 gws schema slides.<resource>.<method>。

這個順序能避免最常見的失敗模式：把錯誤欄位送進一個本來有效的方法裡。

把模糊目標轉成可用提示

好的 gws-slides 請求，會明確寫出資源、方法與結果。不要只說「修我的投影片」，而是像這樣說：「使用 gws-slides 檢查 deck abc123 的 presentations.get 輸出，然後提出一個 batchUpdate 計畫，把標題重新命名並更新第一頁文字。」要包含 deck 識別碼、明確變更，以及像是保留既有版面或避免刪除內容這類限制。

先從 schema 到命令

這個技能的工作流程是以 schema 為先。先用 gws schema 找出必填參數、物件結構與預設值，再把你要做的變更對應成 CLI 旗標或 request body。這對 batchUpdate 特別重要，因為多個操作會一起驗證，只要其中一個請求有誤，整個批次就會失敗。

gws-slides 技能 FAQ

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

不是。只要能照著「先讀 schema 再執行」的流程操作，初學者也能使用。這個技能比單純提示詞更有結構，但正是這種結構能減少錯誤。

gws-slides 跟一般提示詞有什麼不同？

一般提示詞只能描述簡報應該長什麼樣子。gws-slides 則能真正檢查簡報資源，並透過 gws 執行 API 驅動的變更。這讓它更適合做實際編輯，但也代表你必須提供有效的識別碼與 method 細節。

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

如果你只需要創意發想、粗略文案，或非技術性的綱要，就不要用 gws-slides。若你無法使用 Google Workspace CLI 環境，或沒有必要的共享驗證設定，它也不適合你。

安裝前應該先檢查什麼？

先確認你的工作流程是否真的依賴 Google Slides API 操作，以及你是否能滿足 gws-shared 檔案這個前置條件。如果你的 repository 或環境無法支援這個相依性，gws-slides 會很難穩定使用。

如何改善 gws-slides 技能

提供代理程式完整的 deck 背景

最有效的 gws-slides 提示，會包含簡報 ID、目標資源與預期動作。如果是新 deck，就直接說明；如果已經存在，也要說明變更是否必須保留目前投影片、順序或講者備註。這樣可以減少猜測，也更有機會讓第一個命令就有效。

要求 API 方法，不只說結果

這個技能在你直接指定預期操作時最有效，例如 presentations.get 或 presentations.batchUpdate。如果你只說「更新這份 deck」，代理程式就得自行推斷方法，還可能走到不完整的路徑。方法導向的請求，會讓 gws-slides 的使用結果更好。

先讀一次，再迭代修正

實用的流程是先檢查 deck，再根據回傳結構細修需求。拿到第一輪輸出後，把提示收斂到你真正要改的頁面、欄位或批次操作。這通常比一開始就把每張投影片的細節全寫死更有效。

小心 batchUpdate 驗證失敗

gws-slides 最常見的失敗模式，是 batch 裡面某個 request object 不合法。要避免這種情況，請先把批次拆小，用 gws schema 驗證參數名稱，等每個操作都確認有效後，再把它們組合起來。