mcpField
C
cost-summary

cost-summary

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

cost-summary について

cost-summary は、cost-tracking と federation-spend からコスト状況を取得するスクリプトインターフェースです。プラグイン、スクリプト、ダッシュボード、ボット向けに Markdown または定型 JSON を出力し、MCP ツール登録は保留されています。

主な機能

  1. 01複数のコストソースを集約
  2. 02安定した JSON 出力
  3. 03Markdown 出力に対応
  4. 04名前空間と形式の設定

活用シーン

  1. 01他のプラグインからコスト状況を取得
  2. 02ダッシュボードや Slackbot へのデータ提供
  3. 03コスト状況の集約スナップショット取得

MCP 対応

MCP ツールの登録は明示的に保留されています。コマンドラインスクリプトから Markdown または JSON でコストデータを出力します。

インストール

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

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

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

詳細

コストサマリー

ほかのプラグイン、スクリプト、ダッシュボードがシェルから実行し、解析できる、安定した単一呼び出しインターフェースです。ADR-0002では、cost_report／cost_summaryを正式なMCPツールとして公開する案が検討されましたが、その対応は延期されました。MCPツールの追加には@claude-flow/cliのソース変更が必要であり、プラグイン内の作業範囲外だからです。このスクリプトは同等の役割を果たし、同じデータを標準出力のJSON形式の契約を通じて公開します。

使用する場面

  • 別のプラグインでコスト状況のスナップショットが必要な場合は、summary.mjs --format jsonを実行し、その結果を解析します。
  • ダッシュボード／Slackbotが、1行のコスト概要を取得する場合。
  • すべてのコスト追跡ソース（cost-tracking + federation-spend）から情報を取得して、「今の状況は？」をすばやく確認する場合。

出力の契約（JSON、安定）

{
  "exportedAt": "<ISO>",
  "total_cost_usd": 1546.36,
  "sessionCount": 1,
  "conversationCount": 1,
  "byTier": { "haiku": 0, "sonnet": 0, "opus": 1546.36, "unknown": 0 },
  "byModel": {
    "claude-opus-4-7": {
      "tier": "opus",
      "cost_usd": 1546.36,
      "messages": 1597,
      "input_tokens": 3090,
      "output_tokens": 3295940,
      "cache_creation_input_tokens": 10659599,
      "cache_read_input_tokens": 732833690
    }
  },
  "topSession": {
    "sessionId": "1dba3b8c-...",
    "total_cost_usd": 1546.36,
    "messageCount": 1597
  },
  "budget": {
    "budget_usd": 2500.00,
    "setAt": "<ISO>",
    "spent_usd": 1546.36,
    "utilization": 0.6185,
    "level": "INFO"
  },
  "federation": {
    "eventCount": 0,
    "peerCount": 0,
    "totalUsd24h": 0
  }
}

手順

# Markdown (default)
node plugins/ruflo-cost-tracker/scripts/summary.mjs

# JSON for programmatic consumption
node plugins/ruflo-cost-tracker/scripts/summary.mjs --format json

任意の環境変数：SUMMARY_NAMESPACE=cost-tracking、SUMMARY_FED_NAMESPACE=federation-spend、SUMMARY_FORMAT=json。

関連項目

  • cost-report — 説明形式のレポート（エージェント別／モデル別の視点。同じデータを使用）
  • cost-export — Prometheus／webhookにデータを送信します（このスキルはプル形式、エクスポートはプッシュ形式です）
  • ADR-0002 §"Decision" — 正式なMCPツール登録を将来のADRまで明示的に延期しています

コメント

Markdown 対応