mcpField
T
token-budget

token-budget

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

token-budget について

Agent向けにコンテキスト使用量を見積もり、必要なファイルだけを読むためのスキルです。予算のしきい値、段階的な読み込み、圧縮の指針を示します。

主な機能

  1. 01トークンとファイルサイズの見積もり
  2. 02コンテキスト予算のしきい値
  3. 03段階的なファイル読み込み
  4. 04検索してから読み込み
  5. 05予算アラートと状態スナップショット

活用シーン

  1. 01タスク前のコンテキストコスト見積もり
  2. 02読み込むソース量の判断
  3. 03ファイルの再読込削減
  4. 04長いセッションのコンテキスト管理

インストール

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

$npx skills add https://github.com/toonight/get-shit-done-for-antigravity --skill token-budget

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

詳細

トークン予算スキル

あなたはトークン効率を重視するエージェントです。トークン消費を最小限に抑えながら、出力の品質を最大化することが役割です。

基本原則： すべてのトークンが重要です。必要なものだけを、必要なときに読み込みます。

トークンの推定

簡易推定
コンテンツの種類1行あたりのトークン数備考
コード~4-6冗長さによって異なります
Markdown~3-4コードより密度が低くなります
JSON/YAML~5-7構造化されており、反復が多くなります
コメント~3-4自然言語です

経験則： トークン数 ≈ 行数 × 4

ファイルサイズのカテゴリ
カテゴリ行数推定トークン数対応
小<50<200自由に読み込みます
中50-200200-800まず概要を確認します
大200-500800-2000検索と抜粋を使用します
特大500+2000+全体を読み込まないでください

予算のしきい値

PROJECT_RULES.md のコンテキスト品質しきい値に基づきます。

使用率品質予算の状態
0-30%PEAK✅ そのまま進めます
30-50%GOOD⚠️ 選択的に進めます
50-70%DEGRADING🔶 圧縮して要約します
70%+POOR🛑 状態ダンプが必要です

予算の追跡手順

各タスクの開始前

  1. 現在の使用量を推定します：

    • コンテキスト内のファイル数を数えます
    • ファイルごとのトークン数を推定します
    • 概算の使用率を計算します

  2. 予算の状態を確認します：

    Current: ~X,000 tokens (~Y%)
Budget: [PEAK|GOOD|DEGRADING|POOR]

  3. 方針を調整します：

    • PEAK：通常どおり進めます
    • GOOD：検索を優先します
    • DEGRADING：概要のみを使用します
    • POOR：状態ダンプを開始します
実行中

累積コンテキストを追跡します：

## Token Tracker

| Phase | Files Loaded | Est. Tokens | Cumulative |
|-------|--------------|-------------|------------|
| Start | 0 | 0 | 0 |
| Task 1 | 2 | ~400 | ~400 |
| Task 2 | 3 | ~600 | ~1000 |

最適化の戦略

1. 段階的な読み込み
Level 1: Outline only (function signatures)
Level 2: + Key functions (based on task)
Level 3: + Related code (if needed)
Level 4: Full file (only if essential)
2. 必要なときに読み込む
  • タスクで必要になった場合にのみファイルを読み込みます
  • タスクの完了後は、読み込んだ内容を意識から外します
  • 念のために事前読み込みしないでください
3. 読み込み前に検索する

必ず最初に context-fetch スキルを使用します：

  1. 関連する用語を検索します
  2. 候補となるファイルを特定します
  3. 必要なセクションのみを読み込みます
4. 要約して圧縮する

ファイルの内容を把握した後：

  • 重要な知見を STATE.md に記録します
  • 再読する代わりに要約を参照します
  • 「X を分析したところ、Y を行います」という形式を使用します

予算アラート

予算の50%に達した場合
⚠️ TOKEN BUDGET: 50%
Switching to efficiency mode:
- Outlines only for new files
- Summarizing instead of loading
- Recommending compression
予算の70%に達した場合
🛑 TOKEN BUDGET: 70%
Quality degradation likely. Recommend:
1. Create state snapshot
2. Run /pause
3. Continue in fresh session

統合

このスキルは以下と統合されています：

  • context-fetch — 読み込み前に検索
  • context-health-monitor — 品質の追跡
  • context-compressor — 圧縮の戦略
  • /pause と /resume — セッションの引き継ぎ

アンチパターン

❌ 「コンテキストのため」にファイルを読み込む — まず検索します
❌ 同じファイルを再読する — 1回だけ要約します
❌ 抜粋で十分なのにファイル全体を読む — 対象を絞って読み込みます
❌ 予算の警告を無視する — 品質が低下します

GSD v1.6 トークン最適化の一部です。効率化のルールについては PROJECT_RULES.md を参照してください。

コメント

Markdown 対応