Strategic Compact

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

mturac d7eea18 1.9 KB Updated

File contents

策略性壓縮技能

在工作流程的策略點建議手動 /compact,而非依賴任意的自動壓縮。

為什麼需要策略性壓縮?

自動壓縮在任意點觸發:

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

邏輯邊界的策略性壓縮:

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

運作方式

suggest-compact.js 腳本在 PreToolUse(Edit/Write)執行並:

  1. 追蹤工具呼叫 - 計算工作階段中的工具呼叫次數
  2. 門檻偵測 - 在可設定門檻建議(預設:50 次呼叫)
  3. 定期提醒 - 門檻後每 25 次呼叫提醒一次

Hook 設定

新增到你的 ~/.codex/settings.json

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit",
        "hooks": [{ "type": "command", "command": "node ~/.codex/scripts/hooks/suggest-compact.js" }]
      },
      {
        "matcher": "Write",
        "hooks": [{ "type": "command", "command": "node ~/.codex/scripts/hooks/suggest-compact.js" }]
      }
    ]
  }
}

設定

環境變數:

  • COMPACT_THRESHOLD - 第一次建議前的工具呼叫次數(預設:50)

最佳實務

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

相關

  • Longform Guide - Token 優化章節
  • 記憶持久性 hooks - 用於壓縮後存活的狀態

mturac/everything-openai-codex/tree/main/docs/zh-TW/skills/strategic-compact commit d7eea187e0

Frequently asked questions

npx skillmds@latest add mturac/strategic-compact-6