| name | token-budget-advisor |
| description | 在回答之前为用户提供关于响应深度消耗的知情选择。当用户明确想要控制响应长度、深度或 token 预算时使用此技能。 触发条件："token budget"、"token count"、"token usage"、"token limit"、 "response length"、"answer depth"、"short version"、"brief answer"、 "detailed answer"、"exhaustive answer"、"respuesta corta vs larga"、 "cuántos tokens"、"ahorrar tokens"、"responde al 50%"、"dame la versión corta"、"quiero controlar cuánto usas"，或用户明确要求控制回答大小或深度的明确变体。 不触发条件：用户在当前会话中已指定了级别（维持它）、请求明显只需一个词回答、 或"token"指的是认证/会话/支付 token 而非响应大小。 |
| origin | community |
Token 预算顾问（TBA）
在 Claude 回答之前拦截响应流程，为用户提供响应深度的选择。
何时使用
- 用户想要控制响应的长度或详细程度
- 用户提到 token、预算、深度或响应长度
- 用户说"短版本"、"tldr"、"简要"、"al 25%"、"详尽"等
- 用户想要预先选择深度/详细级别
不触发条件：用户本次会话已设置级别（静默维持），或答案明显只需一行。
工作原理
步骤 1 — 估算输入 token 数
使用仓库的标准上下文预算启发式方法在心里估算提示词的 token 数。
使用与 context-budget 相同的校准指导：
- 散文：
词数 × 1.3
- 代码密集或混合/代码块：
字符数 / 4
对于混合内容，使用主要内容类型并保持启发式估算。
步骤 2 — 按复杂度估算响应大小
对提示词进行分类，然后应用乘数范围获取完整响应窗口：
| 复杂度 | 乘数范围 | 示例提示词 |
|---|
| 简单 | 3x - 8x | "X 是什么？"、是/否、单一事实 |
| 中等 | 8x - 20x | "X 是怎么工作的？" |
| 中高 | 10x - 25x | 带上下文的代码请求 |
| 复杂 | 15x - 40x | 多部分分析、比较、架构 |
| 创意 | 10x - 30x | 故事、散文、叙事写作 |
响应窗口 = input_tokens × mult_min 到 input_tokens × mult_max（但不超过模型配置的输出 token 限制）。
步骤 3 — 展示深度选项
在回答之前展示此区块，使用实际估算的数字：
正在分析您的提示词...
输入：~[N] token | 类型：[type] | 复杂度：[level] | 语言：[lang]
选择您的深度级别：
[1] 精简 (25%) -> ~[tokens] 仅直接回答，无前言
[2] 适中 (50%) -> ~[tokens] 回答 + 背景 + 1 个示例
[3] 详细 (75%) -> ~[tokens] 完整回答，含替代方案
[4] 详尽 (100%) -> ~[tokens] 所有内容，无限制
选择哪个级别？（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% 深度" / "短版本" / "简要回答" / "tldr" | 25% |
| "2" / "50% 深度" / "适中深度" / "平衡回答" | 50% |
| "3" / "75% 深度" / "详细回答" / "全面回答" | 75% |
| "4" / "100% 深度" / "详尽回答" / "完整深入分析" | 100% |
如果用户在会话早期已设置级别，静默维持后续响应，除非他们改变。
精度说明
此技能使用启发式估算 — 不是真正的分词器。准确率约 85-90%，偏差 ±15%。始终展示免责声明。
示例
触发条件
- "先给我短版本。"
- "你的回答会用多少 token？"
- "以 50% 深度回答。"
- "我要详尽回答，不是摘要。"
- "Dame la version corta y luego la detallada."
不触发条件
- "什么是 JWT token？"
- "结账流程使用支付 token。"
- "这正常吗？"
- "完成重构。"
- 用户已为会话选择深度后的后续问题
来源
独立技能，来自 TBA — Token Budget Advisor for Claude Code.
原始项目也附带 Python 估算脚本，但本仓库保持技能自包含且仅使用启发式方法。
