gws-keep

gws-keep 技能概覽

gws-keep 的用途

gws-keep 是 googleworkspace/cli 中的 Google Keep 技能，用來透過 gws CLI 管理 Keep 筆記。它最適合需要建立、列出、檢視或刪除筆記，但不想手動撰寫 API 呼叫的代理程式或使用者。

適合安裝給誰

如果你希望 Google Keep 操作有一套可重複的工作流程，特別是在腳本化或代理協作的環境中，就適合安裝 gws-keep 技能。它很適合在動作前先確認 CLI 的辨識是否正確、是否已完成驗證，以及清楚理解這個技能能做什麼、不能做什麼的使用者。

它和其他技能有什麼不同

這個技能是以命令為中心、而且直接對應 API，不是泛泛而談 Keep 的通用提示。它聚焦在 gws keep <resource> <method> [flags]，因此當你需要一條從意圖到命令的可預期路徑，而不是對話式摘要時，gws-keep 指南就特別有用。

如何使用 gws-keep 技能

安裝並載入正確的情境

要進行 gws-keep 安裝，請使用 repository 的 skill 路徑，然後先閱讀必要的共用技能：
npx skills add googleworkspace/cli --skill gws-keep

這個技能明確依賴 ../gws-shared/SKILL.md 來處理驗證、全域 flags 與安全規則。如果你在 checkout 裡找不到那個檔案，請先執行 gws generate-skills，再使用 gws-keep。

先從命令探索開始

在決定要用哪個 method 之前，先用下列指令檢查可用的功能範圍：
gws keep --help

這是確認你本地版本中實際可用命令、resource 名稱與 flags 的最快方式。這個 repo 也建議先看這些核心區塊：先讀 SKILL.md，再讀共用技能檔，接著查看任何顯示 method 細節的 CLI help 輸出。

把模糊需求變成可用的提示

有效的 gws-keep 使用提示，應該明確寫出 resource、動作與結果。例如：

• 「根據這份會議摘要建立一則 Google Keep 筆記，標題用專案名稱。」
• 「列出我的筆記，並找出與 Q2 上線相關的那些。」
• 「只有在這則筆記屬於我的情況下才刪除它。」

這種具體程度很重要，因為 notes 支援不同 method，而且副作用也不同；尤其刪除是不可逆的。

先了解實際限制

gws-keep 最重要的邊界在於權限與 resource 類型。刪除需要 OWNER 角色，筆記列表可能會分頁，附件下載也只有在媒體 MIME type 可用時才行。如果你的工作涉及附件、分頁或刪除，請一開始就把這些限制講清楚，這樣技能才能選對處理路徑。

gws-keep 技能 FAQ

gws-keep 只用於 Google Keep 嗎？

是的。gws-keep 技能是給 gws CLI 生態系中的 Google Keep 筆記使用，不是給一般筆記 App，也不是拿來做任意文件編輯。

也需要共用的 gws 技能嗎？

通常需要。技能本身的說明把 ../gws-shared/SKILL.md 視為驗證、全域 flags 與安全行為的必要內容，所以在有這個共用情境時，gws-keep 才能發揮最好效果。

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

如果你只需要一則單次的自然語言草稿，沒有任何實際的 Keep API 動作，就不要用 gws-keep；如果你無法提供像 delete 這類操作所需的權限安全指令，也不適合使用。若你需要大規模筆記搬遷，或是不符合 CLI methods 的離線編輯，這個技能也不是好選擇。

新手也適合嗎？

適合，只要先從 gws keep --help 開始，並把第一個請求保持簡單。新手通常一次只要求一個動作，例如 create 或 list，會比一次串很多操作更快成功。

如何改進 gws-keep 技能

把筆記意圖講得夠精準

想要更好的 gws-keep 結果，請明確說出這則筆記是草稿、待辦、會議筆記，還是以附件為主的筆記。也請附上標題、內文，以及你在意的任何標籤或擁有權限制。輸入越具體，模型就越不需要自行推斷 Keep 筆記的結構。

把邊界案例直接說清楚

最常見的失敗情況，包括刪除需求太模糊、沒有交代分頁預期，以及附件需求不明。如果你要的是「所有筆記」，請說明希望跨頁結果怎麼處理。如果你需要下載，請直接寫出附件名稱與預期格式，這樣 gws-keep 指南才不會憑空猜測不支援的 MIME type。

先從安全的唯讀命令開始迭代

比較穩妥的流程，是先用 list 或 get 確認目標筆記，再進一步做 create 或 delete。若是 gws-keep for Office Documents 或其他內容量較大的筆記，先確認來源文字是否完整，以及目標筆記標題是否明確，能降低誤改風險，也讓輸出更值得信任。