mcpField
C
context-budget-guard

context-budget-guard

github.com/archieindianエージェントワークフロー7351 回インストール26 週間前に更新
リポジトリ

context-budget-guard について

context-budget-guardは、長時間のセッションや複数段階の作業でコンテキスト使用量を追跡するOpenClawスキルです。推定使用量が70%を超えると、コンテキストの圧縮を促します。

主な機能

  1. 01セッション状態の初期化と管理
  2. 02作業チェックポイントで使用量を推定
  3. 0370%超過時にコンテキスト管理を開始
  4. 04圧縮情報とセッション終了を記録

活用シーン

  1. 01長時間のセッションで使用量を監視
  2. 02ワークフローの主要段階前に確認
  3. 03大きなファイルやサブエージェントの前に圧縮

インストール

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

$npx skills add https://github.com/archieindian/openclaw-superpowers --skill context-budget-guard

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

check.py
example-state.yaml
STATE_SCHEMA.yaml

詳細

コンテキスト予算ガード

状態ファイル：~/.openclaw/skill-state/context-budget-guard/state.yaml

モデルの一貫性が失われるまで待たないでください。95%ではなく、70%で対処します。

使用するタイミング

  • 長時間実行するセッション（30分超の見込み）の開始時
  • 数時間にわたるワークフローの主要な各ステップの前
  • long-running-task-management が新しいステージに進んだとき

プロセス

ステップ 1：初期化（セッション開始時）

状態に、session_start のタイムスタンプ、compaction_count: 0、status: monitoring、threshold_pct: 70 を書き込みます。

ステップ 2：予算を確認（主要な各ステップの前）

現在のコンテキスト使用量を、おおよその割合で推定します。

  • 低（<50%） — 通常どおり続行します
  • 中（50–70%） — 状態に記録し、慎重に進めます（大きなファイルの読み込みを避けます）
  • 高（>70%） — 続行する前に、すぐに context-window-management を実行します

推定方法：直近のメッセージ、読み込んだファイルの内容、アクティブなタスクのコンテキストから、おおよそのトークン数を数えます。

ステップ 3：圧縮後
  • 状態の compaction_count を増やします
  • last_compacted_at と strategy_used（context-window-management から渡された値）を書き込みます
  • メンタル上の推定値を約20%（圧縮後の基準値）にリセットします
ステップ 4：セッション終了時

状態を更新し、status: idle とセッション終了時のタイムスタンプを設定します。

重要な原則

  • 70%が対処を開始する基準です。早いほど常に望ましいです
  • 大きなファイルを読み込んだり、サブエージェントを実行したりする前に予算を確認します。実行後ではありません
  • 迷ったら圧縮します。整理されたコンテキストは、混乱したコンテキストよりもコストがかかりません
  • long-running-task-management と併用すると最も効果的です。各チェックポイントで予算を確認します

コメント

Markdown 対応