Agent skill

strategic-compact

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

Stars 132,726
Forks 19,206

Install this agent skill to your Project

npx add-skill https://github.com/affaan-m/everything-claude-code/tree/main/docs/zh-TW/skills/strategic-compact

SKILL.md

策略性壓縮技能

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

為什麼需要策略性壓縮?

自動壓縮在任意點觸發:

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

邏輯邊界的策略性壓縮:

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

運作方式

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

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

Hook 設定

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

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

設定

環境變數:

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

最佳實務

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

相關

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

Expand your agent's capabilities with these related and highly-rated skills.

affaan-m/everything-claude-code

python-testing

Python testing best practices using pytest including fixtures, parametrization, mocking, coverage analysis, async testing, and test organization. Use when writing or improving Python tests.

132,726 19,206
Explore
affaan-m/everything-claude-code

golang-patterns

Go-specific design patterns and best practices including functional options, small interfaces, dependency injection, concurrency patterns, error handling, and package organization. Use when working with Go code to apply idiomatic Go patterns.

132,726 19,206
Explore
affaan-m/everything-claude-code

e2e-testing

Playwright E2E testing patterns, Page Object Model, configuration, CI/CD integration, artifact management, and flaky test strategies.

132,726 19,206
Explore
affaan-m/everything-claude-code

agentic-engineering

Operate as an agentic engineer using eval-first execution, decomposition, and cost-aware model routing. Use when AI agents perform most implementation work and humans enforce quality and risk controls.

132,726 19,206
Explore
affaan-m/everything-claude-code

api-design

REST API design patterns including resource naming, status codes, pagination, filtering, error responses, versioning, and rate limiting for production APIs.

132,726 19,206
Explore
affaan-m/everything-claude-code

python-patterns

Python-specific design patterns and best practices including protocols, dataclasses, context managers, decorators, async/await, type hints, and package organization. Use when working with Python code to apply Pythonic patterns.

132,726 19,206
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results