| name | strategic-compact |
| description | Suggests manual context compaction at logical intervals to preserve context through task phases rather than arbitrary auto-compaction. |
策略性壓縮技能
在工作流程的策略點建議手動 /compact,而非依賴任意的自動壓縮。
為什麼需要策略性壓縮?
自動壓縮在任意點觸發:
- 經常在任務中途,丟失重要上下文
- 不知道邏輯任務邊界
- 可能中斷複雜的多步驟操作
邏輯邊界的策略性壓縮:
- 探索後、執行前 - 壓縮研究上下文,保留實作計畫
- 完成里程碑後 - 為下一階段重新開始
- 主要上下文轉換前 - 在不同任務前清除探索上下文
運作方式
suggest-compact.js 腳本在 PreToolUse(Edit/Write)執行並:
- 追蹤工具呼叫 - 計算工作階段中的工具呼叫次數
- 門檻偵測 - 在可設定門檻建議(預設:50 次呼叫)
- 定期提醒 - 門檻後每 25 次呼叫提醒一次
Hook 設定
以外掛安裝? 無需任何設定。外掛的 hooks/hooks.json 已經註冊了 suggest-compact.js(Hook ID pre:edit-write:suggest-compact,在 standard 與 strict hook 設定檔中生效)。請勿將下方區塊複製到 ~/.claude/settings.json — 外掛安裝中不存在 ~/.claude/scripts/,且重複註冊外掛 hook 會導致重複執行。
如果是手動安裝(./install.sh),新增到你的 ~/.claude/settings.json:
{
"hooks": {
"PreToolUse": [
{
"matcher": "Edit",
"hooks": [{ "type": "command", "command": "node ~/.claude/scripts/hooks/suggest-compact.js" }]
},
{
"matcher": "Write",
"hooks": [{ "type": "command", "command": "node ~/.claude/scripts/hooks/suggest-compact.js" }]
}
]
}
}
設定
環境變數:
COMPACT_THRESHOLD - 第一次建議前的工具呼叫次數(預設:50)
最佳實務
- 規劃後壓縮 - 計畫確定後,壓縮以重新開始
- 除錯後壓縮 - 繼續前清除錯誤解決上下文
- 不要在實作中途壓縮 - 為相關變更保留上下文
- 閱讀建議 - Hook 告訴你何時,你決定是否
相關