publico/.agent
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

chore(agent): padronizar salvamento obrigatorio de evidencias de testes em .evidencias

Browse source
This commit is contained in:
Luiz Silva 2026-10-30 11:02:09 -03:00
parent 51261563a4
commit 2e6db7dda6
30 changed files with 91 additions and 69 deletions
Download patch file Download diff file Expand all files Collapse all files

20
global/skills/testar-interface-agent-browser/SKILL.md
View file

@ -2,8 +2,9 @@
name: testar-interface-agent-browser
description: >
Executar testes automatizados de interface (E2E), navegação e validação visual
no frontend utilizando a CLI agent-browser, com janela sempre visível (--headed)
e isolamento mandatório de sessão e contexto (--session <modulo>_<contexto?>).
no frontend utilizando a CLI agent-browser, com janela sempre visível (--headed),
isolamento mandatório de sessão e contexto (--session <modulo>_<contexto?>) e
salvamento obrigatório das evidências na pasta .evidencias/.
scope: global
---
@ -125,12 +126,13 @@ agent-browser --session "${MODULO}_${CONTEXTO}" console
agent-browser --session "${MODULO}_${CONTEXTO}" network
```
### 6. Registrar Evidência Visual
Capture um screenshot para comprovação do resultado do teste:
### 6. Registrar Evidência Visual (Pasta Obrigatória `.evidencias/`)
Capture um screenshot na pasta `.evidencias/` para comprovação do resultado do teste (é proibido salvar evidências fora de `.evidencias/`):
```bash
# Screenshot padrão ou anotado com identificadores visuais
agent-browser --session "${MODULO}_${CONTEXTO}" screenshot evidencias/resultado-sucesso.png
# agent-browser --session "${MODULO}_${CONTEXTO}" screenshot --annotate evidencias/resultado-anotado.png
# Garantir a pasta .evidencias/ e capturar screenshot padrão ou anotado
mkdir -p .evidencias
agent-browser --session "${MODULO}_${CONTEXTO}" screenshot .evidencias/resultado-sucesso.png
# agent-browser --session "${MODULO}_${CONTEXTO}" screenshot --annotate .evidencias/resultado-anotado.png
```
### 7. Encerrar Navegador daquele Contexto
@ -156,7 +158,7 @@ agent-browser --session "${MODULO}_${CONTEXTO}" close
| **Aguardar seletor** | `agent-browser --session <modulo>_<contexto?> wait --selector "<seletor>"` |
| **Inspecionar console** | `agent-browser --session <modulo>_<contexto?> console` |
| **Inspecionar rede** | `agent-browser --session <modulo>_<contexto?> network` |
| **Screenshot** | `agent-browser --session <modulo>_<contexto?> screenshot <arquivo.png>` |
| **Screenshot (em `.evidencias/`)** | `agent-browser --session <modulo>_<contexto?> screenshot .evidencias/<arquivo.png>` |
| **Auditoria a11y (WCAG)** | `agent-browser --session <modulo>_<contexto?> a11y` |
| **Fechar sessão** | `agent-browser --session <modulo>_<contexto?> close` |
@ -217,4 +219,4 @@ agent-browser skills get dogfood
1. **Campos Vuetify (`v-text-field`, `v-select`)**: O `snapshot -i` mapeia diretamente o `textbox` e o `combobox`. Utilize `agent-browser --session "${MODULO}_${CONTEXTO}" fill @ref` ou `click @ref`.
2. **Modais e Diálogos**: Após clicar no botão que abre o modal (`v-dialog`), execute `agent-browser --session "${MODULO}_${CONTEXTO}" wait 500 && agent-browser --session "${MODULO}_${CONTEXTO}" snapshot -i` para interagir com o conteúdo do diálogo.
3. **Reporte de Teste**: Apresente ao operador o roteiro executado, evidências de screenshot e verificação de logs do console.
3. **Reporte de Teste e Evidências em `.evidencias/`**: Salve obrigatoriamente todas as evidências geradas na pasta `.evidencias/` e apresente ao operador o roteiro executado, os links das evidências em `.evidencias/` e a verificação de logs do console.