freeze

freeze skill 概覽

freeze skill 的用途

freeze 是一個保護型技能，會在同一個工作階段內把檔案編輯限制在單一目錄中。它會攔截 Edit 和 Write 在允許路徑之外的操作，所以很適合你想讓 workflow automation agent 只待在某個模組、功能資料夾，或除錯沙箱裡的情境。若你需要 freeze skill 來避免不小心改到一大片範圍，這就是對的選擇。

誰適合安裝它

如果你經常要 agent 在很窄的範圍內除錯、重構或修補程式，而且不希望它「順手」碰到無關檔案，就該安裝 freeze。它特別適合維護者、審查者，以及任何在混合度高或風險較大的 codebase 中工作、比起廣泛自主性更在意編輯邊界的人。

它為什麼不一樣

它最大的差異不是「提醒」，而是「強制執行」。freeze 會透過 pre-tool hook 阻擋允許目錄以外的編輯，這比只在 prompt 裡要求模型保持專注更有力。這也讓 freeze guide 在真正需要隔離控制時更實用，尤其是在一旦偏離就可能付出高代價的工作階段裡。

如何使用 freeze skill

安裝並初始化邊界

進行 freeze install 時，先用 repository 的 skill manager 把技能加入你的環境，接著選擇要鎖住的目錄。因為允許路徑是依 session 決定的，所以技能的設定流程是互動式的。實際操作時，你應該準備好精準回答：「要 freeze 哪個目錄？」而不是只說像「backend」這種模糊範圍。

先讀這些檔案

先從 SKILL.md 開始，理解控制流程，然後查看 bin/check-freeze.sh，看邊界是怎麼被強制執行的。如果你要改寫這個技能，也要一起看 SKILL.md.tmpl，了解產生出來的結構。這些檔案會告訴你 freeze usage 到底允許什麼、會阻擋什麼，以及路徑解析在哪些地方可能出錯或比較寬鬆。

給技能一個精準的提示

最好的輸入是「聚焦的任務」加上「清楚的邊界」。例如：「把 apps/payments 的編輯 freeze 起來，修掉那裡失敗的 unit tests，不要動 shared libraries。」這比「debug 這個 app」好得多，因為 freeze 需要明確的目錄目標，以及能在該範圍內完成的任務。範圍越精準，agent 就越不容易要求例外。

實務工作流程建議

當第一輪應該是外科手術式處理時，就用 freeze：先找出 bug，只在單一資料夾內修補，再驗證結果，而不要把範圍越拉越大。如果任務真的需要跨目錄修改，就不要硬塞進 freeze；不是把允許路徑放寬，就是改用其他工作流程。這個技能最適合「要改的內容本來就有明確邊界」、而且 repository 結構又清楚的情境。

freeze skill 常見問題

freeze 只適合除錯嗎？

不是。除錯很常見，但 freeze skill 也很適合受限重構、功能隔離，以及可供審查且較安全的編輯。重點在於：你是否希望 agent 工作時一直停留在同一個目錄內。

這和一般 prompt 有什麼不同？

一般 prompt 主要是靠模型自己遵守指示。freeze 則是透過 hooks 加上強制執行，所以就算模型想超出範圍，還是會被擋下來。對於 guardrails 很重要的 Workflow Automation 任務來說，這會更可靠。

freeze 對新手友善嗎？

可以，只要使用者能夠明確指出一個目錄。新手最常犯的錯，是把邊界設得太大或太小。如果目錄本身就不夠明確，session 可能會因為你需要釐清範圍而卡住。

什麼時候不該用 freeze？

如果任務預期會跨越多個模組、共享設定，或需要全 repo 的格式化，就不要用它。這種情況下，限制反而會拖慢進度，或造成不必要的 blocked actions。freeze 最適合的是「邊界真的是一個決策」的時候，而不是單純偏好而已。

如何改進 freeze skill

把邊界講得更明確

最大的品質提升，來自於同時指定「確切目錄」和「預期結果」。好的輸入會像是：「把 services/auth 的編輯 freeze 起來，更新 token refresh flow，但不要碰 shared/。」像「修 auth」這種弱輸入，會逼 agent 猜測，也更容易出現被擋下或修不完整的修改。

提供檔案、症狀與限制

要更好地使用 freeze，請一起提供出問題的檔案、觀察到的行為，以及哪些檔案不能動。例如：「只編輯 apps/admin；問題在 src/table.ts；不要改 API contracts。」這能幫助 agent 留在 frozen zone 裡，同時仍然真正解決問題。

注意邊界不匹配

最常見的失敗模式，是任務其實偷偷需要比 frozen directory 更大的範圍。如果 agent 一直碰到 denied writes，通常不是技能壞掉，而是應該把邊界放大，或把任務拆成幾個階段。這不是 bug，而是 freeze 在告訴你：你的計畫和範圍不一致。

第一輪之後再迭代

看完第一輪輸出後，檢查解法是否依賴 frozen path 以外的假設。如果有，就用一兩個具體限制把 prompt 收緊：目標目錄、允許的檔案類型，以及哪些內容必須保持不動。想要拿到最好的 freeze skill 結果，迭代方式應該是釐清範圍，而不是要求更多創意。