gws-modelarmor

gws-modelarmor 技能總覽

gws-modelarmor 的用途

gws-modelarmor 技能可協助你在 googleworkspace/cli 生態系中使用 Google Model Armor。它的工作是透過 Model Armor 範本與相關 API 方法來轉送請求，進而過濾使用者生成內容，提升安全性。

什麼人適合安裝

如果你已經在使用 gws，而且需要一套可重複使用的方法來清理 prompts、清理模型輸出，或建立 Model Armor 範本，卻不想靠猜 API 形狀來碰運氣，那就適合安裝 gws-modelarmor 技能。它特別適合做政策感知自動化、應用強化，或 gws-modelarmor for Security Audit 這類工作流程的團隊。

這個技能的差異在哪裡

它的核心價值不是一個通用的安全提示詞。gws-modelarmor 是可安裝的 CLI 技能，內建命令探索、schema 檢視與輔助命令，能大幅降低反覆試錯的成本。這讓它比一次性 prompt 更適合生產環境式使用，尤其是當你需要把真實輸入正確對應到必填參數時。

如何使用 gws-modelarmor 技能

安裝前提與必要條件

只有在你的環境已經有可用的 gws binary 時，gws-modelarmor install 才有意義。這個技能本身的說明也會指向一個前置共享技能 ../gws-shared/SKILL.md，裡面涵蓋驗證、全域 flags 與安全規則。如果你的工作區裡沒有那個共享技能，請先執行 gws generate-skills。

基本呼叫方式

請使用技能中示範的命令形式：gws modelarmor <resource> <method> [flags]。在呼叫任何動作之前，先檢查 CLI 表面：

gws modelarmor --help
gws schema modelarmor.<resource>.<method>

這是避免 --params 或 --json 輸入格式錯誤的最快方式，也是實務上 gws-modelarmor usage 的核心。

把模糊目標轉成強而有力的 prompt

好的 gws-modelarmor guide 輸入，應該明確說出三件事：你想清理什麼內容、輸出要往哪個方向走，以及你能接受多少誤判。舉例來說，不要只說「清理這段文字」，而是要提供內容類型、你在意的風險，還有你是在清理 prompt、response，或建立 template。這些額外脈絡能幫助技能選到正確的 helper command 與 method 形式。

先讀哪些檔案最有幫助

先從 SKILL.md 開始，再讀它連結到的共享技能 ../gws-shared/SKILL.md。接著把 gws modelarmor --help 和 gws schema 當成即時參考，因為這個 repository 沒有額外的 rules/、resources/ 或 helper scripts 可以依賴。實務上，CLI schema 才是目前參數的真正準則。

gws-modelarmor 技能 FAQ

gws-modelarmor 只適合開發者嗎？

不是。只要你已經在 gws 工作流程裡，並且需要安全、可重複的內容過濾，它就很適合。非開發者如果願意閱讀 command help 並提供結構化輸入，也還是能用，但它不是那種用自然語言就能輕鬆對話的技能。

什麼情況下不該用它？

如果你只需要非正式的安全檢視，或者你根本沒有在使用 gws CLI，就不建議用 gws-modelarmor。這些情況下，通用 prompt 或人工審查可能更快。這個技能最適合的是：輸出必須可重現，且要和 Model Armor 行為緊密對應的場景。

這跟一般 prompt 有什麼不同？

一般 prompt 可以描述安全任務，但 gws-modelarmor 提供的是 CLI 路徑、helper commands 與 schema discovery。當你需要精準參數、穩定呼叫，或希望流程能跨多次執行重複使用，而不用每次重寫 prompt 時，這些差異就很重要。

這樣就足夠支援安全工作流程了嗎？

通常不夠。請把 gws-modelarmor 視為更大範圍審查或強制流程中的一個受控步驟。對於 gws-modelarmor for Security Audit，你仍然需要組織的政策、記錄機制與核准流程，來決定哪些內容要標記、阻擋，或直接放行。

如何改進 gws-modelarmor 技能

提供內容類型與決策目標

提升品質最大的關鍵，是講清楚你要清理的是什麼，以及你心中的「好結果」長什麼樣。比如說：「清理客服 prompts 中的不安全指令，但保留產品名稱」就比「讓這段內容更安全」有用得多。這能降低過度過濾，也能幫助模型保留仍然有價值的文字。

根據任務選對 command

使用 +sanitize-prompt 處理使用者輸入，使用 +sanitize-response 處理模型輸出，而當你的任務是政策設定而非一次性過濾時，則用 +create-template。選錯 helper command 是常見失敗原因，因為內容流向比文字本身更重要。

迭代前先檢查 schema

如果輸出不對，不要猜 flags。請重新執行 gws schema modelarmor.<resource>.<method>，把必填欄位、型別與預設值和你的輸入逐一比對。這通常是修正格式錯誤請求最快的方法，也往往比重寫 prompt 更有用。

用真實例子反覆修正

如果你想讓 gws-modelarmor skill 表現更好，就用幾個具代表性的輸入來測試：一個安全範例、一個邊界範例，以及一個明確不安全的範例。把差異拿來收斂你的 template 或 prompt 用語，尤其是在你希望 gws-modelarmor usage 裡減少誤判時更是如此。