Strategic Compact

affaan-m/ECC/docs/zh-TW/skills/strategic-compact

by affaan-mef648e01899ba3e8dc6371642deaaf64b4477775No license275K starsListed Oct 9, 2026Updated Oct 9, 2026Repository updated 4 days ago

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

Instructions onlyAI & Agents Productivity & Workflow

AI-generated overview

Advises when to manually compact an agent's context at logical task boundaries instead of relying on automatic compaction.

What it does: This skill provides guidance on suggesting manual context compaction at strategic points in a workflow, such as after exploration and before execution, after completing a milestone, or before a major context switch. It describes a hook script that counts tool calls during a session, triggers a suggestion at a configurable threshold (default 50 calls), and reminds periodically thereafter. It also documents hook configuration for plugin and manual installs, an environment variable for the threshold, and best practices for when to compact.
When to use it: Use it when working on long, multi-step tasks where automatic compaction risks losing important context mid-task. It is meant for deciding when to compact context at logical boundaries rather than at arbitrary points.
Requirements: The document describes a Node.js hook script (suggest-compact.js) registered via PreToolUse hooks for Edit and Write, plus an optional COMPACT_THRESHOLD environment variable; the skill itself ships no scripts and is instructions only.

策略性壓縮技能

在工作流程的策略點建議手動 /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：

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" }]      }    ]  }}

{  "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 告訴你何時，你決定是否

Source and attribution

Source:affaan-m/ECCindocs/zh-TW/skills/strategic-compactat commitef648e0

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal

Strategic Compact

策略性壓縮技能

為什麼需要策略性壓縮？

運作方式

Hook 設定

設定

最佳實務

相關

Source and attribution

More from affaan-m/ECC

Unified Notifications Ops

Verification Loop

Ui To Vue

Unified Memory

Visa Doc Translate

Team Builder

More in AI & Agents

Ppt Template Creator

Skill Development

Plugin Structure

Command Development

Claude Md Improver

Find Skills