📺 Skill Spec

Agente de Live Chat

Spec genérica para skills que detectam lives, entram no chat e respondem com contexto, limites e fallback de modelo.

Spec GenéricaLive detectionChat agentFallback controlado

1. Objetivo da Skill

Detectar transmissões ao vivo elegíveis, iniciar um agente contextualizado para o chat e responder com moderação, limites e logs auditáveis.

2. Contrato de Entrada e Saída

Entradas

fonte da live ou canal monitorado
credenciais de plataforma
persona e contexto editorial
políticas de cooldown, rate limit e fallback

Saídas

mensagens no chat ao vivo
estado de execução do agente
logs e métricas
opcionalmente transcrição ou sinais de áudio

3. Fluxo Canônico

Detecção: Verificar se existe live ativa e se ela é elegível para iniciar o agente.
Bootstrap: Carregar persona, contexto, limites e dados da live antes do loop principal.
Leitura do chat: Consumir mensagens, filtrar ruído e escolher oportunidades válidas de resposta.
Resposta: Gerar mensagem com modelo principal e fallback, então publicar no chat.
Encerramento: Parar o agente ao fim da live e manter logs para auditoria ou reativação.

4. Pontos de Adaptação

a plataforma pode ser YouTube, Twitch, Spaces ou outra live com chat acessível
a resposta pode usar um único provider ou cadeia de fallback
áudio e transcrição são opcionais na spec
o start pode vir de detector dedicado, operador humano ou automação externa

5. Regras Permanentes

não responder em excesso nem competir com o apresentador
respeitar cooldown, limites por usuário e janelas de silêncio
degradar com segurança se plataforma ou provider falharem
manter logging suficiente para revisão posterior

6. Relação com Workflow

O workflow interno mostra os scripts, providers e dívidas técnicas do ASPIRA. A Skill Spec descreve o comportamento genérico da capability de live chat.

Leitura correta
Skill Spec = portável, genérica, instalável
Workflow = específico, operacional, real