mcpField
L
loop-budget

loop-budget

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

loop-budget について

loop-budget は、自動化ループのトークン使用量、日次上限、一時停止フラグを各実行の開始時と終了時に確認するエージェントスキルです。上限に応じて制限または終了し、実行状況を記録します。

主な機能

  1. 01日次上限と一時停止フラグの確認
  2. 02パターン別のトークン使用量追跡
  3. 03予算しきい値で報告専用モードへ移行
  4. 04対応事項がない場合の早期終了
  5. 05実行ログとアラートの更新

活用シーン

  1. 01定期的な自動処理のトークン消費制限
  2. 02予算枯渇時のループ停止
  3. 03対応事項がない場合のサブエージェント起動回避

インストール

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

$npx skills add https://github.com/cobusgreyling/loop-engineering --skill loop-budget

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

詳細

ループ予算ガード

すべてのループ反復の開始時と終了時に実行してください。

実行の開始時

  1. loop-budget.md を読み、日次上限とキルスイッチフラグを確認します。
  2. loop-run-log.md の直近のエントリー（過去24時間）を読みます。
  3. 今日のアクティブなパターンについて、tokens_estimate を合計します。
  4. 消費量がパターンの日次上限の80%以上の場合 → レポートのみモード（サブエージェントの起動、自動修正は行いません）。
  5. 消費量が90%以上で、STATE.md に優先度の高い項目が残っている場合は、budget-negotiator スキル（インストールされている場合）に処理を委ねます。それ以外の場合、消費量が100%以上、または loop-pause-all が設定されている場合は、STATE.md に1行のメモを残して直ちに終了します。
  6. ウォッチリスト／状態に対応可能な項目がない場合は、5kトークン未満で終了します（サブエージェントを起動しないでください）。

実行の終了時

loop-run-log.md にJSONオブジェクトを1つ追記します。

{
  "run_id": "<ISO8601>",
  "pattern": "<pattern-id>",
  "duration_s": <number>,
  "items_found": <number>,
  "actions_taken": <number>,
  "escalations": <number>,
  "tokens_estimate": <number>,
  "outcome": "no-op | report-only | fix-proposed | escalated"
}

ルール

  • loop-budget.md の max sub-agent spawns/run を超えないでください。
  • 高頻度パターン（CI Sweeper、PR Babysitter）は、対応可能な項目がない場合、必ず早期終了してください。
  • 自己スロットリングを行った場合は、loop-budget.md の Alerts This Period の下に1行追記してください。

コメント

Markdown 対応