kitorz/token-step-tracker

Alertas de Tokens No para Virgos

Realiza un seguimiento aproximado del uso de tokens sin interrumpir la tarea ni reclamar precisión de facturación.

Comenzar el seguimiento

1. Divide la tarea en pasos significativos basados en resultados. Mantén el plan existente si ya hay uno.
2. Indica una vez que las cifras de tokens son estimaciones y excluyen tokens ocultos del sistema, razonamiento y overhead de la plataforma.
3. Lee un intervalo de alerta entero positivo de la solicitud del usuario, como 5000 en "alertar cada 5000 tokens". Usa 10000 cuando el usuario solicite alertas sin especificar un intervalo. Indica el intervalo activo una vez.
4. Establece el siguiente umbral de alerta en un intervalo y avanza en el intervalo después de cada alerta.
5. No hagas llamadas extra a herramientas, releas archivos ni generes contenido adicional solo para mejorar una estimación.

Reportar cada paso completado

Agrega este punto de control compacto después de reportar el resultado útil del paso:

Punto de control de tokens · Paso {n}: {nombre}
Este paso: ≈{bajo}–{alto} tokens | Acumulado: ≈{bajo}–{alto}
Principal impulsor: {fuente observable más grande}
Próximo ahorro: {una sugerencia práctica o "Sin cambio valioso: mantén el enfoque actual."}

Cuenta un paso solo cuando produce un resultado significativo. No crees puntos de control para mensajes de estado, aprobaciones, esperas o acciones internas triviales.

Mostrar alertas de umbral

Después de cada punto de control, compara el punto medio del rango acumulado con el siguiente umbral de alerta. Cuando alcanza o supera el umbral, agrega:

> :red_circle: ALERTA DE TOKENS | **{umbral} tokens estimados usados**

Usa un círculo rojo más dígitos en negrita como fallback portátil. Si el host admite colores HTML seguros en línea, renderiza el valor como <span style="color:#d00"><strong>{umbral}</strong></span>; nunca emitas códigos de escape de terminal sin procesar. Un skill puro no puede crear una notificación del sistema operativo ni garantizar el color del texto, así que llama a esto una alerta, no un popup del sistema.

Si un paso cruza múltiples umbrales, emite una alerta para el umbral más alto cruzado y avanza el siguiente umbral más allá del punto medio acumulado. Nunca repitas un umbral ya emitido.

Estimar de manera consistente

Estima a partir del contenido observable procesado o producido durante el paso:

• Prosa en inglés: aproximadamente 1 token por cada 4 caracteres.
• Prosa en chino: aproximadamente 1 token por cada 1.5–2 caracteres.
• Código y datos estructurados: aproximadamente 1 token por cada 3 caracteres.
• Incluye texto de prompt relevante, salida de herramientas recién leída, contenido generado y contexto reutilizado visiblemente para el paso.
• Evita contar dos veces el mismo artefacto dentro de un paso.
• Usa un rango de al menos ±25% de ancho; amplíalo cuando la reutilización del contexto no esté clara.
• Redondea los límites a valores sensatos. Prefiere ≈800–1,200, no ≈917–1,143.
• Agrega rangos de paso para mantener el rango acumulado.

Nunca infieras tokens de razonamiento ocultos, instrucciones de la plataforma, comportamiento de caché, facturación o costo monetario. Si el runtime proporciona explícitamente el uso, repórtalo por separado como uso exacto del runtime en lugar de mezclarlo con la estimación.

Recomendar ahorros

Da como máximo una recomendación por punto de control. Apunta al costo evitable más grande observado:

• Lecturas grandes de archivos: busca primero, luego lee solo las secciones que coinciden.
• Lecturas o búsquedas repetidas: reutiliza el resultado ya obtenido.
• Salida de herramientas amplia: reduce rutas, campos, rangos de fechas o recuentos de resultados.
• Contexto sobredimensionado: resume hallazgos estables antes de continuar.
• Salida generada larga: solicita o produce un formato más conciso cuando el detalle no sea necesario.
• Fallos repetidos: inspecciona el error y cambia el enfoque antes de reintentar.
• Ejemplos excesivos: mantén un ejemplo representativo a menos que se requiera comparación.

No recomiendes omitir validación, comprobaciones de seguridad, evidencia requerida o detalles solicitados por el usuario solo para reducir tokens. Si no hay un ahorro significativo, dilo en lugar de inventar consejos.

Finalizar el seguimiento

Incluye un resumen breve después del resultado final de la tarea:

Resumen de estimación de tokens
Pasos: {contador} | Total: ≈{bajo}–{alto} tokens
Paso más grande: {nombre del paso} (≈{bajo}–{alto})
Intervalo de alerta: {intervalo} tokens | Alertas emitidas: {contador}
Mejor ahorro para próxima ejecución: {sugerencia de mayor impacto}
Precisión: Solo estimación; excluye overhead oculto del sistema, razonamiento, caché y plataforma.

Mantén los puntos de control y el resumen en un segundo plano respecto a la tarea real del usuario.