O que webapp-debug-skill faz?
Habilidade de agente para descobrir funcionalidades de aplicações web, gerar histórias de usuário e testes Playwright, e rastrear resultados de testes e defeitos no Google Sheets.
Visão Geral
Esta habilidade permite que agentes de IA automatizem a descoberta de funcionalidades de aplicações web, a geração de histórias de usuário e testes Playwright, e o rastreamento de resultados de testes e defeitos em uma planilha do Google Sheets.
Fluxo de Trabalho
- Descoberta de Funcionalidades: O agente navega pela aplicação web e identifica suas funcionalidades principais.
- Geração de Histórias de Usuário: Para cada funcionalidade descoberta, o agente gera histórias de usuário no formato Gherkin.
- Criação de Testes Playwright: O agente cria testes Playwright end-to-end com base nas histórias de usuário.
- Execução de Testes: O agente executa os testes Playwright e coleta os resultados.
- Rastreamento de Defeitos: Quaisquer falhas ou defeitos são registrados em uma planilha do Google Sheets.
- Atualização de Resultados: Todos os resultados de teste e defeitos são sincronizados com o Google Sheets para rastreamento contínuo.
Pré-requisitos
- Acesso ao Google Sheets (credenciais OAuth 2.0)
- Playwright instalado no ambiente
- Navegador web headless ou com interface gráfica
Como Usar
- Configure as credenciais do Google Sheets (defina a variável de ambiente
GOOGLE_SHEETS_CREDENTIALScom o JSON da conta de serviço). - Execute o agente com o comando:
agent run --skill Rhine-Laboratry/webapp-debug-skill --target-url https://exemplo.com
- O agente começará a descobrir funcionalidades, gerar histórias de usuário, criar e executar testes, e registrar resultados no Google Sheets.
Estrutura da Planilha do Google Sheets
O agente criará ou atualizará uma planilha com as seguintes abas:
| Aba | Descrição |
|---|---|
| Funcionalidades | Lista de funcionalidades descobertas com descrições e prioridade |
| Histórias de Usuário | Histórias de usuário geradas no formato Gherkin |
| Testes Playwright | Código dos testes Playwright e status de execução |
| Defeitos | Defeitos registrados com descrição, severidade e status |
| Resultados | Resultados detalhados de cada execução de teste |
Exemplo de Histórico de Usuário Gerado
Funcionalidade: Login de Usuário
Como um usuário registrado
Quero fazer login no sistema
Para acessar minha conta
Cenário: Login bem-sucedido
Dado que estou na página de login
Quando insiro credenciais válidas
E clico no botão "Entrar"
Então devo ser redirecionado para o painel
Solução de Problemas
- Se a descoberta de funcionalidades falhar, verifique se a URL alvo está acessível.
- Se os testes Playwright falharem, certifique-se de que o Playwright está instalado (
npm install playwright). - Se o Google Sheets não for atualizado, valide as credenciais e as permissões da planilha.
Suporte
Para problemas ou sugestões, abra uma issue no repositório do GitHub: Rhine-Laboratry/webapp-debug-skill.
Licença
MIT