Token Budget Advisor (TBA)
Claude が回答する 前に、応答の深さをユーザーが選択できるよう、応答フローに割り込みます。
使用するタイミング
- ユーザーが応答の長さや詳細度を制御したい場合
- ユーザーがトークン、予算、深さ、応答長に言及した場合
- ユーザーが「short version」「tldr」「brief」「al 25%」「exhaustive」などを発言した場合
- ユーザーが事前に詳細度/深さを選択したい場合
トリガーしない場合：ユーザーがすでにセッション内でレベルを設定している（そのレベルを静かに維持する）、または回答が明白に1行である場合。
仕組み
ステップ 1 — 入力トークンの推定
リポジトリの標準的なコンテキスト予算ヒューリスティックを使用して、プロンプトのトークン数を推定します。
context-budget と同じキャリブレーションガイダンスを使用します：
- 散文：
単語数 × 1.3 - コード主体または混合/コードブロック：
文字数 / 4
混合コンテンツの場合は、支配的なコンテンツタイプを使用し、推定ヒューリスティックを維持します。
ステップ 2 — 複雑度による応答サイズの推定
プロンプトを分類し、乗数範囲を適用して応答ウィンドウ全体を取得します：
| 複雑度 | 乗数範囲 | プロンプトの例 |
|---|---|---|
| 単純 | 3倍 – 8倍 | 「Xとは？」、はい/いいえ、単一の事実 |
| 中程度 | 8倍 – 20倍 | 「Xはどのように機能するのか？」 |
| 中程度-高 | 10倍 – 25倍 | コンテキスト付きのコードリクエスト |
| 複雑 | 15倍 – 40倍 | 多部構成の分析、比較、アーキテクチャ |
| 創造的 | 10倍 – 30倍 | ストーリー、エッセイ、ナラティブライティング |
応答ウィンドウ = input_tokens × mult_min から input_tokens × mult_max（ただし、モデルの設定された出力トークン制限を超えないようにします）。
ステップ 3 — 深さオプションの提示
回答する 前に、実際の推定値を使用してこのブロックを表示します：
プロンプトを分析中...
入力: ~[N]トークン | タイプ: [type] | 複雑度: [level] | 言語: [lang]
深さレベルを選択してください：
[1] 最小限 (25%) -> ~[tokens] 直接回答のみ、前置きなし
[2] 標準 (50%) -> ~[tokens] 回答 + コンテキスト + 1つの例
[3] 詳細 (75%) -> ~[tokens] 代替案を含む完全な回答
[4] 網羅的 (100%) -> ~[tokens] すべて、制限なし
どのレベルにしますか？（1-4 または「25% depth」「50% depth」「75% depth」「100% depth」と入力）
精度：ヒューリスティック推定 約85～90%（±15%）。
レベルトークン推定値（応答ウィンドウ内）：
- 25% →
min + (max - min) × 0.25 - 50% →
min + (max - min) × 0.50 - 75% →
min + (max - min) × 0.75 - 100% →
max
ステップ 4 — 選択されたレベルで応答する
| レベル | 目標の長さ | 含むもの | 省略するもの |
|---|---|---|---|
| 25% 最小限 | 最大2～4文 | 直接回答、主要な結論 | コンテキスト、例、ニュアンス、代替案 |
| 50% 標準 | 1～3段落 | 回答 + 必要なコンテキスト + 1つの例 | 深い分析、エッジケース、参考文献 |
| 75% 詳細 | 構造化された応答 | 複数の例、メリット/デメリット、代替案 | 極端なエッジケース、網羅的な参考文献 |
| 100% 網羅的 | 制限なし | すべて — 完全な分析、すべてのコード、すべての視点 | なし |
ショートカット — 質問をスキップ
ユーザーがすでにレベルを示している場合、質問せずにすぐにそのレベルで応答します：
| ユーザーの発言 | レベル |
|---|---|
| 「1」/「25% depth」/「short version」/「brief answer」/「tldr」 | 25% |
| 「2」/「50% depth」/「moderate depth」/「balanced answer」 | 50% |
| 「3」/「75% depth」/「detailed answer」/「thorough answer」 | 75% |
| 「4」/「100% depth」/「exhaustive answer」/「full deep dive」 | 100% |
ユーザーがセッション内で以前にレベルを設定した場合、変更がない限り 静かにそのレベルを維持 し、後続の応答では尋ねません。
精度に関する注意
このスキルはヒューリスティック推定を使用します — 実際のトークナイザーは使用しません。精度は約85～90%、ばらつきは±15%です。常に免責事項を表示してください。
例
トリガーされる場合
- 「最初に短い版をください。」
- 「あなたの回答は何トークンになりますか？」
- 「50%の深さで応答してください。」
- 「要約ではなく、網羅的な回答が欲しい。」
- 「最初に短い版、次に詳細版をください。」
トリガーされない場合
- 「JWTトークンとは何ですか？」
- 「チェックアウトフローは支払いトークンを使用します。」
- 「これは正常ですか？」
- 「リファクタリングを完了してください。」
- ユーザーがすでにセッションの深さを選択した後のフォローアップ質問
ソース
TBA — Token Budget Advisor for Claude Code からのスタンドアロンスキル。 元のプロジェクトにはPython推定スクリプトも含まれていますが、このリポジトリではスキルを自己完結型かつヒューリスティックのみに保っています。