O que Conselheiro de Orçamento de Tokens (TBA) faz?
Intercepta o fluxo de resposta para oferecer ao usuário uma escolha sobre a profundidade da resposta antes de Claude responder.
Quando usar
- O usuário deseja controlar o tamanho ou detalhamento de uma resposta
- O usuário menciona tokens, orçamento, profundidade ou tamanho da resposta
- O usuário diz "versão curta", "resumo", "breve", "al 25%", "exaustivo", etc.
- Sempre que o usuário quiser escolher o nível de profundidade/detalhe antecipadamente
Não acionar quando: o usuário já definiu um nível nesta sessão (mantenha-o silenciosamente), ou a resposta é trivialmente de uma linha.
Como funciona
Passo 1 — Estimar tokens de entrada
Use as heurísticas canônicas de orçamento de contexto do repositório para estimar mentalmente a contagem de tokens do prompt.
Use a mesma calibração do context-budget:
- prosa:
palavras × 1,3 - código pesado ou misto/blocos de código:
caracteres / 4
Para conteúdo misto, use o tipo de conteúdo dominante e mantenha a heurística de estimativa.
Passo 2 — Estimar tamanho da resposta por complexidade
Classifique o prompt e aplique a faixa de multiplicadores para obter a janela total de resposta:
| Complexidade | Faixa de multiplicador | Exemplos de prompt |
|---|---|---|
| Simples | 3× – 8× | "O que é X?", sim/não, fato único |
| Média | 8× – 20× | "Como funciona X?" |
| Média-Alta | 10× – 25× | Solicitação de código com contexto |
| Complexa | 15× – 40× | Análise de múltiplas partes, comparações, arquitetura |
| Criativa | 10× – 30× | Histórias, ensaios, escrita narrativa |
Janela de resposta = tokens_entrada × mult_min a tokens_entrada × mult_max (mas não exceda o limite de tokens de saída configurado do seu modelo).
Passo 3 — Apresentar opções de profundidade
Apresente este bloco antes de responder, usando os números estimados reais:
Analisando seu prompt...
Entrada: ~[N] tokens | Tipo: [tipo] | Complexidade: [nível] | Idioma: [idioma]
Escolha seu nível de profundidade:
[1] Essencial (25%) -> ~[tokens] Apenas resposta direta, sem preâmbulo
[2] Moderado (50%) -> ~[tokens] Resposta + contexto + 1 exemplo
[3] Detalhado (75%) -> ~[tokens] Resposta completa com alternativas
[4] Exaustivo (100%) -> ~[tokens] Tudo, sem limites
Qual nível? (1-4 ou diga "25% de profundidade", "50% de profundidade", "75% de profundidade", "100% de profundidade")
Precisão: estimativa heurística ~85-90% de precisão (±15%).
Estimativas de tokens por nível (dentro da janela de resposta):
- 25% →
min + (max - min) × 0,25 - 50% →
min + (max - min) × 0,50 - 75% →
min + (max - min) × 0,75 - 100% →
max
Passo 4 — Responder no nível escolhido
| Nível | Tamanho alvo | Inclui | Omite |
|---|---|---|---|
| 25% Essencial | Máx. 2-4 frases | Resposta direta, conclusão principal | Contexto, exemplos, nuances, alternativas |
| 50% Moderado | 1-3 parágrafos | Resposta + contexto necessário + 1 exemplo | Análise profunda, casos extremos, referências |
| 75% Detalhado | Resposta estruturada | Múltiplos exemplos, prós/contras, alternativas | Casos extremos de borda, referências exaustivas |
| 100% Exaustivo | Sem restrição | Tudo — análise completa, todo código, todas as perspectivas | Nada |
Atalhos — pule a pergunta
Se o usuário já sinalizar um nível, responda nesse nível imediatamente sem perguntar:
| O que eles dizem | Nível |
|---|---|
| "1" / "25% de profundidade" / "versão curta" / "resposta breve" / "resumo" | 25% |
| "2" / "50% de profundidade" / "profundidade moderada" / "resposta equilibrada" | 50% |
| "3" / "75% de profundidade" / "resposta detalhada" / "resposta minuciosa" | 75% |
| "4" / "100% de profundidade" / "resposta exaustiva" / "mergulho profundo completo" | 100% |
Se o usuário definiu um nível anteriormente na sessão, mantenha-o silenciosamente para respostas subsequentes, a menos que ele o altere.
Nota de precisão
Esta skill usa estimativa heurística — nenhum tokenizador real. Precisão ~85-90%, variação ±15%. Sempre exiba o aviso.
Exemplos
Gatilhos
- "Me dê primeiro a versão curta."
- "Quantos tokens sua resposta usará?"
- "Responda com 50% de profundidade."
- "Quero a resposta exaustiva, não o resumo."
- "Dame la versión corta y luego la detallada."
Não aciona
- "O que é um token JWT?"
- "O fluxo de checkout usa um token de pagamento."
- "Isso é normal?"
- "Complete a refatoração."
- Perguntas de acompanhamento depois que o usuário já escolheu uma profundidade para a sessão
Fonte
Skill independente do TBA — Token Budget Advisor para Claude Code. O projeto original também inclui um script estimador em Python, mas este repositório mantém a skill autocontida e apenas heurística.