affaan-m/ECC/docs/zh-TW/skills/strategic-compact/SKILL.md
strategic-compact
Suggests manual context compaction at logical intervals to preserve context through task phases rather than arbitrary auto-compaction.
- Source repository stars
- 234,327
- Declared platforms
- 0
- Static risk flags
- 0
- Last source update
- 2026-07-27
- Source checked
- 2026-07-28
Decision brief
What it does—and where it fits
在工作流程的策略點建議手動 /compact,而非依賴任意的自動壓縮。
Not for
- Tasks that require unconfirmed production actions or broad system permissions.
- Environments where the pinned source and install steps cannot be inspected.
Compatibility matrix
Platform support, with evidence labels
| Platform | Status | Evidence | What to check |
|---|---|---|---|
| Codex | Not declared | No explicit evidence | Portability before use |
| Claude Code | Not declared | No explicit evidence | Portability before use |
| Cursor | Not declared | No explicit evidence | Portability before use |
| Gemini CLI | Not declared | No explicit evidence | Portability before use |
Installation
Inspect first. Install second.
The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.
npx skills add https://github.com/affaan-m/ECC --skill "docs/zh-TW/skills/strategic-compact"Inspect the Agent Skill "strategic-compact" from https://github.com/affaan-m/ECC/blob/4e973d3eaf92d97f8d2e2d8abb39d8bdc8711b38/docs/zh-TW/skills/strategic-compact/SKILL.md at commit 4e973d3eaf92d97f8d2e2d8abb39d8bdc8711b38. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.
Workflow
What the source asks the agent to do
- 01
為什麼需要策略性壓縮?
自動壓縮在任意點觸發: - 經常在任務中途,丟失重要上下文 - 不知道邏輯任務邊界 - 可能中斷複雜的多步驟操作
經常在任務中途,丟失重要上下文不知道邏輯任務邊界可能中斷複雜的多步驟操作 - 02
運作方式
suggest-compact.js 腳本在 PreToolUse(Edit/Write)執行並:
追蹤工具呼叫 - 計算工作階段中的工具呼叫次數門檻偵測 - 在可設定門檻建議(預設:50 次呼叫)定期提醒 - 門檻後每 25 次呼叫提醒一次 - 03
Hook 設定
以外掛安裝? 無需任何設定。外掛的 hooks/hooks.json 已經註冊了 suggest-compact.js(Hook ID pre:edit-write:suggest-compact,在 standard 與 strict hook 設定檔中生效)。請勿將下方區塊複製到 /.claude/settings.json — 外掛安裝中不存在 /.claude/scripts/,且重複註冊外掛 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:
Permission review
Static risk signals and limitations
No configured static risk pattern was detected
This is not proof of safety. Runtime behavior, indirect dependencies, and hidden external systems are outside the static scan.
Evidence record
Why each signal appears
| Signal | Value | Evidence type | Meaning |
|---|---|---|---|
| Quality score | 63/100 | Computed | Documentation, specificity, maintenance, and trust rules |
| Repository stars | 234,327 | Source | Repository attention, not individual Skill quality |
| Compatibility | 0 platforms | Source | Declared in the catalog source record |
| Usage guide | catalog record | Editorial | Generated or reviewed according to the visible evidence level |
Pinned source
Provenance and original SKILL.md
- Repository
- affaan-m/ECC
- Skill path
- docs/zh-TW/skills/strategic-compact/SKILL.md
- Commit
- 4e973d3eaf92d97f8d2e2d8abb39d8bdc8711b38
- License
- MIT
- Collected
- 2026-07-28
- Default branch
- main
View the original SKILL.md
策略性壓縮技能
在工作流程的策略點建議手動 /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 告訴你何時,你決定是否
相關
- Longform Guide - Token 優化章節
- 記憶持久性 hooks - 用於壓縮後存活的狀態
Alternatives
Compare before choosing
affaan-m/ECC
strategic-compact
Suggests manual context compaction at logical intervals to preserve context through task phases rather than arbitrary auto-compaction.
affaan-m/ECC
strategic-compact
Suggests manual context compaction at logical intervals to preserve context through task phases rather than arbitrary auto-compaction.
affaan-m/ECC
strategic-compact
Suggests manual context compaction at logical intervals to preserve context through task phases rather than arbitrary auto-compaction.
affaan-m/ECC
strategic-compact
Review strategic-compact's use cases, installation, workflow, and original source instructions.