Habilidade de Teste ScoutQA

Execute testes exploratórios com IA em aplicações web usando a CLI scoutqa.

Pense no ScoutQA como um parceiro de teste inteligente que pode explorar autonomamente, descobrir problemas e verificar funcionalidades. Delegue testes para múltiplas execuções paralelas do ScoutQA para maximizar a cobertura enquanto economiza tempo.

Quando Usar Esta Habilidade

Use esta habilidade em dois cenários:

1. Solicitações de teste do usuário - Quando o usuário pede explicitamente para testar um site ou verificar uma funcionalidade.
2. Verificação proativa - Após implementar funcionalidades web, execute testes automaticamente para verificar se a implementação funciona corretamente.

Exemplo de uso proativo:

• Após implementar um formulário de login → Teste o fluxo de autenticação.
• Após adicionar validação de formulário → Verifique as regras de validação e o tratamento de erros.
• Após construir um fluxo de checkout → Teste o processo de compra de ponta a ponta.
• Após corrigir um bug → Verifique se a correção funciona e não quebrou outras funcionalidades.

Melhor prática: Ao terminar de implementar uma funcionalidade web, inicie proativamente um teste ScoutQA em segundo plano para verificar se ela funciona enquanto você continua com outras tarefas.

Executando Testes

Fluxo de Trabalho de Teste

Copie esta lista de verificação e acompanhe seu progresso:

Progresso do Teste:

• Escrever um prompt de teste específico com expectativas claras
• Executar o comando scoutqa em segundo plano
• Informar o usuário sobre o ID da execução e o URL do navegador
• Extrair e analisar os resultados

Passo 1: Escrever um prompt de teste específico

Veja a seção "Escrevendo Prompts Eficazes" abaixo para obter diretrizes.

Passo 2: Executar o comando scoutqa

IMPORTANTE: Use o parâmetro de tempo limite da ferramenta Bash (5000ms = 5 segundos) para capturar os detalhes da execução:

Ao chamar a ferramenta Bash, defina timeout: 5000 como um parâmetro:

• Este é o parâmetro de tempo limite integrado da ferramenta Bash no Claude Code (NÃO o comando Unix timeout).
• Após 5 segundos, a ferramenta Bash retorna o controle com um ID de tarefa e o processo continua em execução em segundo plano.
• Isso é diferente do timeout do Unix, que encerra o processo - aqui o processo continua em execução.
• Os primeiros 5 segundos capturam o ID da execução e o URL do navegador da saída do ScoutQA.
• O teste continua em execução remotamente na infraestrutura do ScoutQA com a tarefa em segundo plano.

scoutqa --url "https://example.com" --prompt "Your test instructions"

Nos primeiros segundos, o comando exibirá:

• ID da Execução (ex: 019b831d-xxx)
• URL do Navegador (ex: https://app.scoutqa.ai/t/019b831d-xxx)
• Chamadas iniciais de ferramenta mostrando o progresso do teste.

Após o tempo limite de 5 segundos, a ferramenta Bash retorna um ID de tarefa e o comando continua em execução em segundo plano. Você pode trabalhar em outras tarefas enquanto o teste é executado. O tempo limite é apenas para capturar a saída inicial (ID da execução e URL do navegador) - o teste continua em execução tanto localmente como uma tarefa em segundo plano quanto remotamente na infraestrutura do ScoutQA.

Passo 3: Informar o usuário sobre o ID da execução e o URL do navegador

Após a ferramenta Bash retornar com o ID da tarefa (tendo capturado os detalhes da execução nos primeiros 5 segundos), informe o usuário sobre:

• O ID da execução do ScoutQA e o URL do navegador para que eles possam monitorar o progresso em seu navegador.
• O ID da tarefa em segundo plano, caso queiram verificar a saída do comando local mais tarde.

O teste continua em execução em segundo plano enquanto você continua com outros trabalhos.

Passo 4: Extrair e analisar os resultados

Veja a seção "Apresentando Resultados" abaixo para o formato completo.

Opções de Comando

• --url (obrigatório): URL do site para testar (suporta localhost / 127.0.0.1).
• --prompt (obrigatório): Instruções de teste em linguagem natural.
• --project-id (opcional): Associar a um projeto para rastreamento.
• -v, --verbose (opcional): Mostrar todas as chamadas de ferramenta, incluindo as internas.

Suporte a Testes Locais

O ScoutQA suporta o teste autônomo de URLs localhost e 127.0.0.1 — nenhuma configuração manual é necessária.

# Seamlessly test a locally running app when you're developing your app
scoutqa --url "http://localhost:3000" --prompt "Test the registration form"

Quando Usar Cada Comando

Iniciando um novo teste? → Use scoutqa --url --prompt Verificando um problema conhecido? → Use scoutqa issue-verify --issue-id <id> Encontrando IDs de problemas de uma execução? → Use scoutqa list-issues --execution-id <id> Agente precisa de mais contexto? → Use scoutqa send-message (veja "Acompanhamento de Execuções Travadas")

Escrevendo Prompts Eficazes

Concentre-se em o que explorar e verificar, não em passos prescritivos. O ScoutQA determina autonomamente como testar.

Exemplo: Fluxo de registro de usuário

…