cost-report

コストレポート

指定した期間のトークン使用量、米ドルでのコスト、予算の消化状況を網羅したコストレポートを生成します。

使用する場面

現在の支出状況（各エージェントのコスト、最も予算を消費しているモデル、予算内に収まる見込みかどうか）を把握したい場合に使用します。

手順

1. 使用状況を取得する -- 指定した期間（デフォルト：今日）について、cost-tracking 名前空間の mcp__plugin_ruflo-core_ruflo__memory_search（または _list／_retrieve）を呼び出します。memory_* ツールは名前空間文字列に基づいてルーティングされます。一方、agentdb_hierarchical-* ツールはそうではなく、working|episodic|semantic の階層に基づいてルーティングされるため、ここでは使用しないでください。ルーティングの仕様については、ruflo-agentdb ADR-0001 §「名前空間の規約」を参照してください。 1a. 実測ブースターデータを読み込む -- docs/benchmarks/runs/latest.json が存在する場合は、Bash から node -e 'console.log(JSON.stringify(JSON.parse(require("fs").readFileSync("docs/benchmarks/runs/latest.json")).summary))' を実行して読み込みます。これにより、Tier 1 の実測値（ブースターのコスト／編集（$0）、平均レイテンシ、勝率）と、実行済みの LLM ベースライン（Gemini、Sonnet 4.6、Opus 4.7 のレイテンシと編集あたりのコスト）が取得できます。ステップ4では、推定値ではなく、これらをTier別の実測値として使用します。
2. コストを計算する -- 各レコードについて、モデルの料金に基づいてコストを計算します。
   • Haiku：入力 $0.25/M、出力 $1.25/M
   • Sonnet：入力 $3.00/M、出力 $15.00/M
   • Opus：入力 $15.00/M、出力 $75.00/M
   • 該当する場合は、キャッシュへの書き込み／読み取りコストも含めます
3. モデル別に集計する -- モデルごとにコストを合計し、構成比を計算します
4. Tier別に集計する -- 3つのシグナルを優先順位順に使って、各レコードをTier 1／Tier 2／Tier 3に分類します。(a) ステップ1aのベンチマークデータ：実測ブースターのインテントに該当するレコードには、$0／実測レイテンシを直接使用します。(b) cost-tracking の cost-booster-route スキルが保存した [AGENT_BOOSTER_AVAILABLE] フラグ。(c) フォールバックとしてモデル名（haiku → Tier 2、sonnet／opus → Tier 3）。Tierごとにコストを合計し、構成比を計算し、Tier 1で回避できた件数を数えます。Tier別の内訳は、最も実用的な単一の指標です。これは、Sonnet／Opusの支出のうち、Tier 1で対応できた割合を示します。
5. エージェント別に集計する -- エージェントごとにコストを合計し、各エージェントが使用したモデルを含めます
6. 予算を確認する -- memory_retrieve で予算設定を取得し、消化率を計算して、アラートのしきい値（50%／75%／90%／100%）を確認します
7. レポートを作成する -- 合計コスト、残りの予算、Tier別の内訳（Tier 1／Tier 2／Tier 3）、モデル別の内訳、エージェント別の内訳、有効なアラートを表示します。標準レイアウトについては、REFERENCE.md §「コストレポートの形式」を参照してください。

CLIでの代替方法

npx @claude-flow/cli@latest memory search --query "cost report for today" --namespace cost-tracking
npx @claude-flow/cli@latest memory list --namespace cost-tracking