lyxjack/strategic-compact

Strategic Compactスキル

任意の自動コンパクションに依存するのではなく、ワークフローの戦略的なポイントで手動の/compactを提案します。

なぜ戦略的コンパクションか？

自動コンパクションは任意のポイントでトリガーされます：

• 多くの場合タスクの途中で、重要なコンテキストを失う
• タスクの論理的な境界を認識しない
• 複雑な複数ステップの操作を中断する可能性がある

論理的な境界での戦略的コンパクション：

• 探索後、実行前 - 研究コンテキストをコンパクト、実装計画を保持
• マイルストーン完了後 - 次のフェーズのために新しいスタート
• 主要なコンテキストシフト前 - 異なるタスクの前に探索コンテキストをクリア

仕組み

suggest-compact.shスクリプトはPreToolUse（Edit/Write）で実行され：

1. ツール呼び出しを追跡 - セッション内のツール呼び出しをカウント
2. 閾値検出 - 設定可能な閾値で提案（デフォルト：50回）
3. 定期的なリマインダー - 閾値後25回ごとにリマインド

フック設定

~/.claude/settings.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. 提案を読む - フックはいつを教えてくれますが、するかどうかは自分で決める

関連

• The Longform Guide - トークン最適化セクション
• メモリ永続化フック - コンパクションを超えて存続する状態用