kitorz/token-step-tracker

Alertas de Token Não para Virgem

Rastreie o uso aproximado de tokens sem interromper a tarefa ou alegar precisão de faturamento.

Iniciar rastreamento

1. Divida a tarefa em etapas significativas baseadas em resultados. Mantenha o plano existente se já houver um.
2. Declare uma vez que os valores de token são estimativas e excluem sistema oculto, raciocínio e sobrecarga da plataforma.
3. Leia um intervalo de alerta inteiro positivo da solicitação do usuário, como 5000 em "alertar a cada 5000 tokens." Use 10000 quando o usuário solicitar alertas sem especificar um intervalo. Informe o intervalo ativo uma vez.
4. Defina o próximo limite de alerta como um intervalo e avance-o pelo intervalo após cada alerta.
5. Não faça chamadas extras de ferramentas, releia arquivos ou gere conteúdo adicional apenas para melhorar uma estimativa.

Relatar cada etapa concluída

Anexe este ponto de verificação compacto após relatar o resultado útil da etapa:

Ponto de verificação de token · Etapa {n}: {nome}
Esta etapa: ≈{baixo}–{alto} tokens | Acumulado: ≈{baixo}–{alto}
Principal condutor: {maior fonte observável}
Economizar próximo: {uma sugestão acionável ou "Nenhuma mudança relevante — mantenha a abordagem atual."}

Conte uma etapa apenas quando ela produzir um resultado significativo. Não crie pontos de verificação para mensagens de status, aprovações, esperas ou ações internas triviais.

Mostrar alertas de limite

Após cada ponto de verificação, compare o ponto médio do intervalo acumulado com o próximo limite de alerta. Quando ele atingir ou exceder o limite, anexe:

> :red_circle: ALERTA DE TOKEN | **{limite} tokens estimados usados**

Use um círculo vermelho mais dígitos em negrito como fallback portátil. Se o host suportar cores HTML inline seguras, renderize o valor como <span style="color:#d00"><strong>{limite}</strong></span>; nunca emita códigos de escape de terminal brutos. Uma skill pura não pode criar uma notificação do sistema operacional ou garantir cor de texto, portanto chame isso de alerta, não de pop-up do sistema.

Se uma etapa ultrapassar vários limites, emita um alerta para o maior limite ultrapassado e avance o próximo limite além do ponto médio acumulado. Nunca repita um limite já emitido.

Estimar consistentemente

Estime a partir do conteúdo observável processado ou produzido durante a etapa:

• Prosa em inglês: aproximadamente 1 token para cada 4 caracteres.
• Prosa em chinês: aproximadamente 1 token para cada 1,5–2 caracteres.
• Código e dados estruturados: aproximadamente 1 token para cada 3 caracteres.
• Inclua texto de prompt relevante, saída de ferramenta recém-lida, conteúdo gerado e contexto visivelmente reutilizado para a etapa.
• Evite contar duas vezes o mesmo artefato dentro de uma etapa.
• Use um intervalo de pelo menos ±25% de largura; aumente-o quando a reutilização de contexto não estiver clara.
• Arredonde os limites para valores sensatos. Prefira ≈800–1.200, não ≈917–1.143.
• Adicione os intervalos das etapas para manter o intervalo acumulado.

Nunca infira tokens de raciocínio ocultos, instruções da plataforma, comportamento de cache, faturamento ou custo monetário. Se o runtime fornecer uso exato explicitamente, relate-o separadamente como uso exato do runtime, em vez de misturá-lo na estimativa.

Recomendar economias

Dê no máximo uma recomendação por ponto de verificação. Mire no maior custo evitável observado:

• Grandes leituras de arquivo: pesquise primeiro, depois leia apenas as seções correspondentes.
• Leituras ou pesquisas repetidas: reutilize o resultado já obtido.
• Saída ampla de ferramenta: restrinja caminhos, campos, intervalos de datas ou contagens de resultados.
• Contexto excessivo: resuma descobertas estáveis antes de continuar.
• Saída gerada longa: solicite ou produza um formato mais enxuto quando detalhes forem desnecessários.
• Falhas repetidas: inspecione o erro e mude a abordagem antes de tentar novamente.
• Exemplos excessivos: mantenha um exemplo representativo, a menos que a comparação seja necessária.

Não recomende pular validação, verificações de segurança, evidências exigidas ou detalhes solicitados pelo usuário apenas para reduzir tokens. Se não existir economia significativa, diga isso em vez de inventar conselhos.

Finalizar rastreamento

Inclua um breve resumo após o resultado final da tarefa:

Resumo da estimativa de tokens
Etapas: {contagem} | Total: ≈{baixo}–{alto} tokens
Maior etapa: {nome da etapa} (≈{baixo}–{alto})
Intervalo de alerta: {intervalo} tokens | Alertas emitidos: {contagem}
Melhor economia para próxima execução: {sugestão de maior impacto}
Precisão: Apenas estimativa; exclui sistema oculto, raciocínio, cache e sobrecarga da plataforma.

Mantenha os pontos de verificação e o resumo secundários à tarefa real do usuário.