gws-people

gws-people 技能總覽

gws-people 技能的用途

gws-people 技能是 googleworkspace/cli 中對應 Google People API 的工作流程。它讓你可以透過命令列，使用 gws people 系列命令來管理聯絡人、聯絡人群組，以及與個人檔案相關的紀錄。當你需要可重複執行的聯絡人操作，而不是一次性的提示詞時，就該使用 gws-people 技能。

適合誰安裝

如果你的工作包含 CRM 營運、管理工具或自動化，而且需要一致地檢視、分組或更新聯絡資料，這個技能很適合。當你希望用結構化的 CLI 流程處理 Google People，而不是手動翻 API 文件或猜測 request 形狀時，它特別有用。

採用前最重要的事

gws-people 的核心價值，在於它把工作範圍收斂到特定的資源集合與命令模式：gws people <resource> <method> [flags]。主要門檻則是依賴與情境：你需要 gws binary，以及 ../gws-shared/SKILL.md 裡的共用驗證與安全指引。它也遵循實務上很重要的 API 限制，尤其是同一位使用者的連續變更行為。

如何使用 gws-people 技能

安裝並確認共用設定

使用 npx skills add googleworkspace/cli --skill gws-people 安裝。開始執行前，先確認共用前置條件存在：閱讀 ../gws-shared/SKILL.md，了解驗證、全域 flags 和安全規則。如果你的 workspace 還沒有這份設定，先執行 gws generate-skills。這很重要，因為 gws-people 的使用取決於共用 CLI 慣例，而不只是技能資料夾本身。

讓你的需求對齊命令模式

有效的提示詞應該明確指出資源、方法、目標帳號情境，以及你想達成的結果。例如，可以要求「一個用來檢視我的聯絡人群組的 gws people contactGroups list 命令」或「一個先建立再重新命名聯絡人群組的安全流程」。如果你是在 CRM 營運場景下使用 gws-people，請一併說明你是在稽核、清理、分群還是同步聯絡人，因為這會影響該選哪個資源與方法。

先讀對的檔案

先從 SKILL.md 開始，再查看 ../gws-shared/SKILL.md。如果你正在判斷這個技能是否符合你的工作流程，請先讀 SKILL.md 裡的 API resource 清單。真正的實務界線就在那裡：支援 contactGroups、otherContacts 和 people，但這個技能不是通用 CRM。

以工作流程限制來使用技能

當你針對同一位使用者保持寫入操作的順序，並避免 API 不支援得很好的批次假設時，gws-people 的效果最好。對於高訊號的工作，請直接要求精確的 resource、最安全的 method，以及變更後要做的驗證步驟。如果你不確定目標 resource，先要求 discovery command，再進行變更，不要直接跳到 mutation。

gws-people 技能常見問題

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

不是。只要能跟著 CLI 流程操作，並願意先查看共用的 gws 設定，初學者也能使用。這個技能重點不在寫複雜程式碼，而是在選對 resource 和 method。

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

如果你需要的是完整的 CRM 系統、只能透過 UI 管理聯絡人，或是非 Google 的資料來源，就不適合。當你的任務需要超出 People API 模型之外、未受支援的聯絡人自動化時，它也不是好選擇。

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

一般提示詞可能只會產生泛泛的回答。gws-people 技能會提供命令形式的工作流程、相關的 resource 集合，以及一個關鍵限制：針對同一位使用者的變更請求應該要依序執行。這能在 Google Workspace 管理或 CRM 營運場景中，減少反覆試錯。

主要的安裝依賴是什麼？

關鍵依賴是 gws CLI，以及共用的 gws skill context。如果這一層不存在或設定錯誤，單獨安裝 gws-people 仍不足以讓流程可用。

如何改善 gws-people 技能

給技能一個明確的操作目標

最好的 gws-people 結果，來自會清楚指定物件、動作與範圍的提示詞。像是「列出目前驗證使用者的所有聯絡人群組」就比「幫我處理聯絡人」更好；「更新一個指定名稱的聯絡人群組，而且不要產生重複」也比「修正我的群組」更精準。越精確，技能就越能選到正確的 People resource，並避免不必要的步驟。

加上最重要的作業限制

如果你的任務會涉及寫入，請說明這次變更是否必須安全、依序、可稽核或可回復。repository 已註明同一位使用者的 sequential mutation 行為，而這類細節會實質影響輸出品質。對於 CRM 營運，也請一併說明任務是清理、補強、分群，還是檢視個人檔案。

從探索逐步走到動作

一份好的 gws-people 指南，通常會先從讀取或列出命令開始，再收斂到單一變更。如果第一個輸出太廣泛，就進一步要求精確的 gws people 命令、必要的 flags，以及變更後的驗證檢查。這比一開始就要求完整但泛化的工作流程，更能產生高品質的 gws-people 使用結果。