mcpField
S
strategic-compact

strategic-compact

github.com/worldflowaiエージェントワークフロー5.5k172 回インストール40 週間前に更新
リポジトリ

strategic-compact について

strategic-compact は Claude のワークフロー向けスキルで、タスクの区切りで手動の `/compact` を提案します。フックがツール呼び出しを数えて実行時期を知らせ、実行するかは利用者が判断します。

主な機能

  1. 01ツール呼び出し数の記録
  2. 02提案しきい値の設定
  3. 03しきい値後の定期リマインダー
  4. 04Edit と Write 用の PreToolUse フック

活用シーン

  1. 01探索後、実行前のコンテキスト圧縮
  2. 02マイルストーン後の新フェーズ開始
  3. 03タスク変更前のコンテキスト整理
  4. 04関連する実装中の圧縮回避

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/worldflowai/everything-claude-code --skill strategic-compact

インストール後、Claude Code で/strategic-compactを入力して読み込まれたか確認します。

同梱ファイルsuggest-compact.sh

詳細

戦略的な圧縮スキル

任意の自動圧縮に頼るのではなく、ワークフローの戦略的なタイミングで手動の /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. 提案を確認する - フックは「いつ」圧縮するかを伝えます。「圧縮するかどうか」は自分で判断します

関連項目

  • 長文ガイド - トークン最適化のセクション
  • メモリ永続化フック - 圧縮後も保持される状態のため

コメント