Token 予算アドバイザー (TBA)

Claude が回答する前に応答フローをインターセプトし、ユーザーが回答の深さを選択できるようにします。

使用時期

• ユーザーが回答の長さまたは詳細度を制御したい
• ユーザーが token、予算、深さ、または回答の長さに言及している
• ユーザーが「簡潔版」「長すぎる」「要約」「25%」「詳細」などと言う
• ユーザーが深さ/詳細度を事前に選択したいあらゆる場合

トリガーしない場合：ユーザーがこのセッション内ですでにレベルを設定している（無言で維持）、または回答自体が 1 行のみの場合。

仕組み

ステップ 1 — 入力 token の推定

リポジトリの標準的なコンテキスト予算ヒューリスティックを使用して、プロンプトの token 数を概算的に推定します。

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（ただしモデルの設定出力 token 制限を超えない）。

ステップ 3 — 深さオプションを表示

回答する前にこのブロックを表示し、実際の推定数値を使用します：

プロンプトを分析中...

入力：約 [N] 個の token  |  タイプ：[タイプ]  |  複雑度：[レベル]  |  言語：[言語]

深さレベルを選択してください：

[1] 基本     (25%)  ->  約 [token 数]   直接的な回答、前置きなし
[2] 中程度   (50%)  ->  約 [token 数]   回答 + 背景 + 1 つの例
[3] 詳細     (75%)  ->  約 [token 数]   完全な回答と代替案
[4] 詳尽    (100%)  ->  約 [token 数]   すべてのコンテンツ、制限なし

どのレベルを選びますか？(1-4 または「25% の深さ」「50% の深さ」「75% の深さ」「100% の深さ」と言う)

精度：ヒューリスティック推定の精度は約 85-90%（±15%）です。

各レベルの token 推定（応答ウィンドウ内）：

• 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% の深さ」/「簡潔版」/「簡潔な回答」/「長すぎる」	25%
「2」/「50% の深さ」/「中程度の深さ」/「バランスの取れた回答」	50%
「3」/「75% の深さ」/「詳細な回答」/「包括的な回答」	75%
「4」/「100% の深さ」/「詳尽な回答」/「完全な詳細分析」	100%

ユーザーがこのセッション内でレベルを既に設定している場合、後続の回答は無言でそのレベルを維持し、ユーザーが変更しない限り続けます。

精度に関する注記

このスキルはヒューリスティック推定を使用します — 実際のトークナイザーではありません。精度は約 85-90%、偏差は ±15% です。常に免責事項を表示してください。

例

トリガーするシナリオ

• 「まず簡潔版をください。」
• 「あなたの回答は何 token を使いますか？」
• 「50% の深さで回答してください。」
• 「詳尽な回答がほしい、要約は不要です。」
• 「まず簡潔版、その次に詳細版をください。」

トリガーしないシナリオ

• 「JWT token とは何ですか？」
• 「チェックアウト フローは支払い token を使用します。」
• 「これは正常ですか？」
• 「リファクタリングを完了しました。」
• ユーザーがこのセッションの深さを既に選択した後の後続の質問

出典

TBA — Claude Code の Token 予算アドバイザーからの独立したスキル。 オリジナルプロジェクトには Python 推定スクリプトも含まれていますが、このリポジトリはスキルを自己完結型に保ち、ヒューリスティック方法のみを使用しています。