token-budget-advisor

Token预算顾问（TBA）

在Claude回答之前拦截响应流程，让用户选择回答深度。

何时使用

• 用户希望控制回答的长度或详细程度
• 用户提及token、预算、深度或回答长度
• 用户说"简短版"、"太长不看"、"简要"、"25%"、"详尽"等
• 任何用户希望预先选择深度/详细程度的情况

不要触发当：用户已在本会话中设置了级别（静默保持），或答案本身只有一行。

工作原理

第一步 — 估算输入token

使用仓库的标准上下文预算启发式方法，在脑海中估算提示词的token数量。

使用与context-budget相同的校准指南：

• 散文：words × 1.3
• 代码密集或混合/代码块：chars / 4

对于混合内容，使用主导内容类型并保持估算启发式方法。

第二步 — 按复杂度估算响应大小

对提示词进行分类，然后应用乘数范围获取完整响应窗口：

响应窗口 = input_tokens × mult_min 到 input_tokens × mult_max（但不要超过模型配置的输出token限制）。

第三步 — 呈现深度选项

在回答之前呈现此区块，使用实际估算的数字：

分析您的提示...

输入：~[N] 个令牌  |  类型：[类型]  |  复杂度：[级别]  |  语言：[语言]

选择您的深度级别：

[1] 基础    (25%)  ->  ~[令牌数]   直接回答，无开场白
[2] 适中    (50%)  ->  ~[令牌数]   回答 + 背景 + 1个示例
[3] 详细    (75%)  ->  ~[令牌数]   完整回答及备选方案
[4] 详尽   (100%)  ->  ~[令牌数]   全部内容，无限制

选择哪个级别？(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

第四步 — 按所选级别回答

快捷方式 — 跳过提问

如果用户已表明级别，立即按该级别回答，无需询问：

如果用户在本会话中已设置级别，后续回答静默保持该级别，除非用户更改。

精度说明

此技能使用启发式估算——非真实分词器。准确率约85-90%，偏差±15%。始终显示免责声明。

示例

触发场景

• "先给我简短版。"
• "你的回答会用多少token？"
• "按50%深度回答。"
• "我要详尽的答案，不要摘要。"
• "先给我简短版，再给详细版。"

不触发场景

• "什么是JWT token？"
• "结账流程使用了一个支付token。"
• "这正常吗？"
• "完成重构。"
• 用户已为本会话选择深度后的后续问题

来源

来自TBA — Claude Code的Token预算顾问的独立技能。 原始项目还附带了一个Python估算脚本，但本仓库保持技能自包含且仅使用启发式方法。