budget-negotiator について
budget-negotiator は loop-budget ワークフロー向けのスキルで、予算による強制終了が迫り、優先度の高い作業が残る場合にのみ動作します。実行記録と残件を基に人間のメンテナーへ上限引き上げを申請し、承認待ちの間は処理を停止します。
主な機能
- 01予算による強制終了時のみ起動
- 02当日の実行数と成功結果を集計
- 03残る高優先度項目を確認
- 04メンテナーに上限引き上げを申請
- 05人間の承認まで再開を保留
活用シーン
- 01CI障害が残る場合に予算を申請
- 02高優先度のセキュリティ問題への対応前に延長を依頼
- 03人間が拒否した後にレポート専用へ移行
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ cobusgreyling/ loop-engineering --skill budget-negotiatorインストール後、Claude Code で/budget-negotiatorを入力して読み込まれたか確認します。
詳細
予算交渉
loop-budget スキルを通じて、1 日あたりのトークン上限に近づいている(例:消費量が 90% 以上)と検知した場合、黙って終了してはいけません。投資収益率(ROI)に基づいて、延長を交渉する必要があります。
目標
ループで高い成功率が示され、残りの作業が重要である場合に、トークン予算によって重要な作業が恣意的に妨げられないようにします。
ルールと優先順位
- 優先順位:
budget-negotiatorが有効になるのは、loop-budgetによって通常なら強制終了される場合(つまり、消費量が 90% 以上)で、かつHigh Priorityの項目が残っている場合のみです。作業の優先度がHigh Priorityでない場合は、標準のloop-budget終了手順に従います。 - 安全性:このスキルは L3(無人実行)の安全境界に関わります。脅威モデルについては、安全境界を参照してください。
- 上限の厳守:
loop-budget.mdの上限を自分で引き上げることは固く禁じられています。再開する前に、人間がloop-budget.mdを明示的に編集して上限を引き上げる必要があります。 - 人間による却下:人間が予算の増額をせずに
[BUDGET NEGOTIATION]タグを削除して交渉を却下した場合、報告のみを行うモードに戻り、その日は再度要求してはいけません。 - 要求の上限:交渉 1 回につき、要求できるのは最大 +20% または +50k トークンです。交渉は 1 日につき最大 1 回までです。
交渉プロトコル
-
ROI を計算する:
loop-run-log.mdを読み、今日のactions_taken、outcome(特に成功した結果)、tokens_estimateの各フィールドを合計します。STATE.mdを読み、Watch ListまたはHigh Priorityセクションに残っている対応可能な項目の深刻度を確認します。
-
正当化の根拠を作成する:
- 残っている項目が
High Priority(例:CI が失敗している、P0 のバグ、セキュリティ脆弱性)の場合は、簡潔な業務上の正当化を作成します。 - 正当化には次の内容を含める必要があります。
- 現在の消費量と上限。
- JSON ログに基づく、今日完了した
actions_takenの正確な件数と成功した結果。 - 残っている具体的な重要課題。
loop-budget.mdの具体的なフィールドに紐づけた、明確な延長要求(例:「『Validate/Audit (CI)』の max tokens/day に対し、+50k トークンを要求します」)。
- 残っている項目が
-
人間にエスカレーションする:
[BUDGET NEGOTIATION]タグを付けて、STATE.mdの High Priority セクションに要求を追記します。- 人間のメンテナーがすばやく可否を判断できるよう、要求を明確に記述してください。
- 例:
[BUDGET NEGOTIATION] 今日の「Daily Triage」ループでは、100k トークン中 95k を消費しました。一方で、「fix-proposed」の結果となるアクションを 4 件正常に実行しました。メインブランチには、重要な CI の失敗が 1 件残っています。解決のため、「Daily Triage」の max tokens/day を一時的に +50k 増やすよう要求します。 - 内部状態を
WAITING_FOR_BUDGETに設定し、安全に実行を中断します。
-
再開する:
- 次回の実行時に
loop-budget.mdを読み、人間がトークン上限を引き上げたことを確認するまで、追加のサブエージェントを起動してはいけません。
- 次回の実行時に
コメント
Markdown 対応