Token Budget Advisor(TBA)是一个独立技能,用于 Claude Code,核心作用是在 Claude 回答之前拦截响应流程,先向用户提供关于回答深度的选择,再按所选深度作答。
用途
当用户希望控制回答的长度或详细程度时使用;当用户提到 token、预算、深度或响应长度时使用;当用户说“简短版”“tldr”“brief”“al 25%”“详尽”等表述时使用;任何用户希望预先选择深度或详细级别的场景均可使用。
不触发的场景:用户本次会话中已经设定过级别(应静默保持该级别),或答案本身只有一行、无需选择。
主要能力
该技能通过四个步骤工作。第一步,估算输入 token:使用仓库的规范上下文预算启发式方法,在脑中估算提示词的 token 数。校准方式与 context-budget 一致:散文类按“词数 × 1.3”估算;代码密集或混合/代码块按“字符数 / 4”估算;混合内容按主导内容类型处理并保持该启发式。
第二步,按复杂度估算响应规模:先对提示词分类,再应用乘数范围得到完整响应窗口。复杂度与乘数范围对应如下:简单(3× – 8×),例如“什么是 X?”、是/否、单一事实;中等(8× – 20×),例如“X 如何工作?”;中高(10× – 25×),例如带上下文的代码请求;复杂(15× – 40×),例如多部分分析、比较、架构;创意(10× – 30×),例如故事、文章、叙事写作。响应窗口 = 输入 token × 乘数下限 至 输入 token × 乘数上限,但不超过模型配置的输出 token 上限。
第三步,呈现深度选项:在回答前展示一个区块,使用实际估算数字,包含输入 token 数、类型、复杂度、语言,以及四个深度级别:Essential(25%)仅直接回答、无前言;Moderate(50%)回答 + 上下文 + 1 个示例;Detailed(75%)完整回答并含替代方案;Exhaustive(100%)全部内容、无限制。并提示用户选择 1-4 或说出“25% depth”等。精度说明:启发式估算准确率约 85-90%(±15%)。各级别 token 估算方式:25% → 下限 +(上限 - 下限)× 0.25;50% → 下限 +(上限 - 下限)× 0.50;75% → 下限 +(上限 - 下限)× 0.75;100% → 上限。
第四步,按所选级别作答。25% Essential:最多 2-4 句,包含直接答案与关键结论,省略上下文、示例、细微差别、替代方案。50% Moderate:1-3 段,包含答案 + 必要上下文 + 1 个示例,省略深度分析、边缘情况、参考。75% Detailed:结构化响应,包含多个示例、优缺点、替代方案,省略极端边缘情况、详尽参考。100% Exhaustive:无限制,包含全部内容——完整分析、所有代码、所有视角,不省略任何内容。
使用方式
该技能为独立技能,仓库保持其自包含且仅使用启发式方法。原项目还附带一个 Python 估算脚本,但本仓库未包含。用户可通过选择 1-4 或说出“25% depth”“50% depth”“75% depth”“100% depth”来指定级别。若用户已发出级别信号,则立即按该级别作答,不再询问。对应关系:说“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%。若用户本次会话早前已设定级别,则后续响应静默保持该级别,除非用户更改。
适用场景
适用于用户希望控制回答长度或详细程度的对话,例如“先给我简短版”“你的回答会用多少 token?”“以 50% 深度回答”“我要详尽答案,不要摘要”“Dame la version corta y luego la detallada.”等。
限制
该技能使用启发式估算,没有真实分词器,准确率约 85-90%,方差 ±15%,应始终显示免责声明。不触发的例子包括:“What is a JWT token?”(询问 token 概念而非控制回答深度)、“The checkout flow uses a payment token.”(token 指支付令牌)、“Is this normal?”、“Complete the refactor.”,以及用户已为本次会话选择深度后的后续问题。