Everything-claude-code strategic-compact

Suggests manual context compaction at logical intervals to preserve context through task phases rather than arbitrary auto-compaction.

install

source · Clone the upstream repo

git clone https://github.com/affaan-m/everything-claude-code

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/affaan-m/everything-claude-code "$T" && mkdir -p ~/.claude/skills && cp -r "$T/docs/zh-TW/skills/strategic-compact" ~/.claude/skills/affaan-m-everything-claude-code-strategic-compact-5361c1 && rm -rf "$T"

manifest: docs/zh-TW/skills/strategic-compact/SKILL.md

策略性壓縮技能

在工作流程的策略點建議手動

/compact

，而非依賴任意的自動壓縮。

為什麼需要策略性壓縮？

自動壓縮在任意點觸發：

經常在任務中途，丟失重要上下文
不知道邏輯任務邊界
可能中斷複雜的多步驟操作

邏輯邊界的策略性壓縮：

探索後、執行前 - 壓縮研究上下文，保留實作計畫
完成里程碑後 - 為下一階段重新開始
主要上下文轉換前 - 在不同任務前清除探索上下文

運作方式

suggest-compact.sh

腳本在 PreToolUse（Edit/Write）執行並：

追蹤工具呼叫 - 計算工作階段中的工具呼叫次數
門檻偵測 - 在可設定門檻建議（預設：50 次呼叫）
定期提醒 - 門檻後每 25 次呼叫提醒一次

Hook 設定

新增到你的

~/.claude/settings.json

：

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "tool == \"Edit\" || tool == \"Write\"",
      "hooks": [{
        "type": "command",
        "command": "~/.claude/skills/strategic-compact/suggest-compact.sh"
      }]
    }]
  }
}

設定

環境變數：

```
COMPACT_THRESHOLD
```
- 第一次建議前的工具呼叫次數（預設：50）

最佳實務

規劃後壓縮 - 計畫確定後，壓縮以重新開始
除錯後壓縮 - 繼續前清除錯誤解決上下文
不要在實作中途壓縮 - 為相關變更保留上下文
閱讀建議 - Hook 告訴你何時，你決定是否