cost-budget-check について
cost-budget-check は、設定済み予算に対するプロジェクト支出を確認するスキルです。コスト追跡後やスウォームの起動前に使い、予算使用率を計算し、上限到達時にはゼロ以外の終了コードを返します。
主な機能
- 01セッションコストの合算
- 02予算使用率の計算
- 03閾値に応じた4段階の警告
- 04予算の設定と確認
- 05予算上限到達時の停止
活用シーン
- 01コスト追跡後の警告確認
- 02スウォーム起動前の予算確認
- 03定期的な支出監視
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/cost-budget-checkを入力して読み込まれたか確認します。
詳細
コスト予算チェック
cost-tracking:budget-config を読み込んでプロジェクトの予算上限を取得し、cost-track が生成した session-* レコードの total_cost_usd を合計して使用率を算出し、実際に適用される4段階のアラート（50% INFO／75% WARNING／90% CRITICAL／100% HARD_STOP）を出力します。
このスキル（P2）が導入されるまでは、README にアラートの段階は記載されていましたが、それをチェックするコードはありませんでした。現在は、このスキルがゲートとして機能します。
使用するタイミング
cost-trackの実行後、毎回アラートレベルを確認します。- スウォームを起動する前に、使用率が90%以上の場合は、まず
/cost-optimizeに切り替えます。 - 継続的な監視には、
/loop 30mを使って Cron で実行できます。
手順
-
チェックを実行します：
node plugins/ruflo-cost-tracker/scripts/budget.mjs check期間で絞り込むには、
BUDGET_PERIOD=todayを指定します（デフォルトはall）。機械可読な JSON を使用するには、BUDGET_QUIET=1を指定します。 -
Markdown の概要を確認します — 予算、使用額、残額、使用率、アラートレベル（🟢 OK · 🟡 INFO · 🟠 WARNING · 🔴 CRITICAL · 🛑 HARD_STOP）、推奨アクションが表示されます。
-
予算を設定／確認します：
node plugins/ruflo-cost-tracker/scripts/budget.mjs set 50.00 node plugins/ruflo-cost-tracker/scripts/budget.mjs get -
HARD_STOP の場合 — 使用率が100%以上のとき、
budget.mjs checkは終了コード1で終了します。クリティカルなエージェントの起動はbudget.mjs check && spawn …のガードで囲み、失敗時に処理を中止します。
ストレージ形式（cost-tracking:budget-config）
{
"budget_usd": 50.00,
"setAt": "2026-05-05T...",
"thresholds": { "info": 0.50, "warning": 0.75, "critical": 0.90, "hard_stop": 1.00 }
}
アラートの段階（REFERENCE.md に記載、現在は適用済み）
| しきい値 | レベル | アクション |
|---|---|---|
| 50% | INFO 🟡 | 通知を記録し、UX に影響を与えません |
| 75% | WARNING 🟠 | 警告を表示し、/cost-optimize を提案します |
| 90% | CRITICAL 🔴 | 緊急アラートを出し、モデルのダウングレードを推奨します |
| 100% | HARD_STOP 🛑 | 必須ではない起動を停止し、終了コード 1 で終了します |
関連項目
cost-track（生成元） —cost-tracking:session-*にデータを格納しますcost-report— 同じデータソースを使い、文章形式でレポートしますcost-optimize— WARNING／CRITICAL 時の推奨アクションです- REFERENCE.md の「予算アラートのしきい値」 — このスキルが適用する、文書化された段階です