mcpField
C
cost-compact-context

cost-compact-context

github.com/ruvnetエージェントワークフロー80.0k726 回インストール今日更新
リポジトリ

cost-compact-context について

cost-compact-contextは、コスト分析クエリ向けに@claude-flow/integrationのコンテキスト圧縮機能を実行するスキルです。取得したメモリ、ブリッジが報告するトークン削減量、利用可否、キャッシュヒット率を示し、agentic-flowがない場合も正常に終了します。

主な機能

  1. 01コンテキスト圧縮クエリの実行
  2. 02取得したメモリの報告
  3. 03ブリッジが報告するトークン削減量の表示
  4. 04パッケージの利用可否とキャッシュヒット率の報告
  5. 05agentic-flowがない場合も正常終了

活用シーン

  1. 01クエリのコンテキスト圧縮結果を確認
  2. 02取得メモリとトークン推定値を確認
  3. 03agentic-flowの利用可否を確認
  4. 04キャッシュヒット率を確認

インストール

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

$npx skills add https://github.com/ruvnet/ruflo --skill cost-compact-context

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

詳細

コストコンパクトコンテキスト

コスト分析クエリ向けに、@claude-flow/integration の getTokenOptimizer().getCompactContext() をラップします。このブリッジは agentic-flow を動的にインポートし、利用できない場合は適切にフォールバックします。パッケージがインストールされていない場合、tokensSaved は 0 となり、スキルは正常に終了します。現在、getTokenOptimizer をラップする MCP ツールはありません（ADR-0002 §「最もリスクの高い前提」）。代わりに、Node のワンライナーをシェルから実行します。

手順

  1. クエリを受け取る — 唯一の引数です。

  2. 呼び出す — @claude-flow/integration が解決されるよう、v3/ 以下の任意の場所から実行します。

    ( cd v3 && node ../plugins/ruflo-cost-tracker/scripts/compact.mjs "<QUERY>" )

    スクリプトは @claude-flow/integration/token-optimizer（正規のエクスポート。Node の ./* エクスポートルールによって .js 拡張子が二重になる dist/token-optimizer.js は使用しません）をインポートし、getCompactContext(query) を呼び出して、COMPACT_QUIET=1 を使って Markdown の概要と JSON の行を出力します。

  3. 報告する — 次の項目を含む Markdown テーブルを作成します。取得したメモリ、削減されたトークン数（ブリッジの報告値）、agentic-flow の利用可否、キャッシュヒット率。スクリプトは「ブリッジの報告値であり、RAG を使用しない場合のベースラインとの比較ではない」という免責事項も出力します。ブリッジが利用できない場合は、「agentic-flow がインストールされていません — ブリッジは不活性な結果を返します。」と出力し、正常に終了します。

注意事項 — 上流での主張であり、まだ検証されていません

ルートの CLAUDE.md では、ReasoningBank retrieval: -32% tokens と主張しています。ブリッジの tokensSaved は query_tokens − compact_prompt_tokens です（token-optimizer.ts:141–143）。これはヒューリスティックであり、ベースラインを測定した削減値ではありません。token-optimizer.ts:9–10 自体にも、「捏造した指標は報告しない — すべての統計は実際の測定値を反映する」 と記載されています。このスキルでも、その免責事項を引き継ぎます。

Booster 固有の利用可否はゲッターとして公開されていません。method: 'agent-booster' を返す optimizedEdit() を通してのみ確認できます。正規の Tier 1 シグナルは [AGENT_BOOSTER_AVAILABLE] です（cost-booster-route を参照）。

フォールバック

agentic-flow がインストールされていない場合、getCompactContext は {tokensSaved: 0, memories: []}（116–124 行目）を返し、optimizedEdit は {method: 'traditional'} を返し、getOptimalConfig はアンチドリフトのデフォルト値にフォールバックします。スキルは「利用できません」というメッセージを表示して正常に終了します。

相互参照

ADR-0002 の決定 #2 と §「最もリスクの高い前提」 · token-optimizer.ts:308（シングルトンのエクスポート） · docs/benchmarks/0002-baseline.md（検証結果）。

コメント

Markdown 対応