mtschoen/skills-progress-beacon

O que skills-progress-beacon faz?

Habilidade de auto-pacing para agentes: emite beacons de progresso durante turnos não triviais para renderização de ETA na linha de status.

Visão Geral

Esta habilidade permite que agentes de IA sinalizem seu progresso durante tarefas demoradas, fornecendo à interface do usuário informações sobre a conclusão parcial e o tempo restante estimado.

Funcionamento

• O agente emite um "beacon" de progresso em pontos estratégicos durante a execução de uma tarefa complexa.
• Cada beacon contém informações sobre o estágio atual, porcentagem concluída e timestamp.
• A interface do usuário captura esses beacons e atualiza a barra de progresso ou linha de status em tempo real.

Como Usar

1. Importe a habilidade no seu agente:

   from skills_progress_beacon import ProgressBeacon
   

2. Emita beacons durante a execução:

   beacon = ProgressBeacon(task_id="build", total_steps=10)
   for step in range(10):
       # executa o passo
       beacon.emit(step=step, description="Compilando módulo...")
   

Plataformas Suportadas

• Claude Code
• Cursor
• Codex
• Qualquer ambiente que suporte callbacks de progresso

Notas

• Evite emitir beacons com muita frequência para não sobrecarregar a interface.
• Mantenha as descrições curtas e informativas.