Communitygithub.com

ProofShot — Fluxo de Verificação Visual

Verificação visual de funcionalidades de UI. Use após construir ou modificar qualquer componente de UI, página ou recurso visual. Inicia uma sessão de verificação com gravação de vídeo e captura de erros, então você dirige o navegador para testar, e depois para para empacotar artefatos de prova para o humano.

O que é ProofShot — Fluxo de Verificação Visual?

ProofShot é uma ferramenta CLI de código aberto e agnóstica a agentes de IA que permite verificar visualmente componentes de UI em um navegador real, gerando provas em vídeo, capturas de tela e relatórios de erros. Suporta qualquer plataforma de desenvolvimento web e se integra perfeitamente com ferramentas como Claude Code, Cursor e Codex. O fluxo de trabalho é simples: iniciar uma sessão com um comando de desenvolvimento, navegar e interagir com a interface usando comandos como `open`, `click`, `fill` e `screenshot`, e então parar a sessão para gerar um relatório resumido. Opcionalmente, as provas podem ser postadas automaticamente em pull requests do GitHub. ProofShot é útil para desenvolvedores que precisam validar mudanças visuais sem depender de serviços externos, garantindo que cada alteração seja documentada com evidências claras.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AmElmo/proofshot/tree/HEAD/skills/claude

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que ProofShot — Fluxo de Verificação Visual faz?

ProofShot é um CLI de código aberto e agnóstico a agentes que permite verificar seu próprio trabalho em um navegador real — vídeo prova, capturas de tela e relatórios de erro, sem dependência de fornecedor.

Quando usar

Use ProofShot após:

  • Construir um novo recurso ou página de UI
  • Modificar componentes de UI existentes
  • Corrigir um bug visual
  • Qualquer alteração que afete o que o usuário vê

O fluxo de trabalho (sempre siga estes 3 passos)

Passo 1: Inicie a sessão

proofshot start --run "seu-comando-de-dev" --port PORTA --description "o que você está prestes a verificar"

Isso abre um navegador e começa a gravação. Se a porta já estiver em uso, o proofshot irá matar o processo existente automaticamente.

Sempre use --run para que o proofshot inicie e capture a saída do seu servidor de desenvolvimento (os logs do servidor aparecem no relatório de prova). Omite --run apenas se o servidor foi explicitamente iniciado pelo usuário ou por outro processo — sem ele, nenhum log do servidor é capturado.

Se uma sessão anterior não foi encerrada corretamente, adicione --force para sobrescrevê-la.

Passo 2: Dirija o navegador e teste

Use proofshot exec para navegar, interagir e verificar:

proofshot exec snapshot -i                                    # Veja elementos interativos
proofshot exec open http://localhost:PORTA/pagina             # Navegue para uma página
proofshot exec click @e3                                      # Clique em um botão
proofshot exec fill @e2 "[email protected]"                   # Preencha um campo de formulário
proofshot exec screenshot passo-NOME.png                      # Capture momentos chave

Tire capturas de tela em momentos importantes — elas se tornam a prova visual. Verifique o que você espera ver lendo a saída do snapshot.

Passo 3: Pare e empacote a prova

proofshot stop

Isso para a gravação, coleta erros do console e do servidor, e gera um SUMMARY.md com vídeo, capturas de tela e relatório de erros.

Passo 4 (opcional): Poste a prova no PR

proofshot pr              # Detecta automaticamente o PR da branch atual
proofshot pr 42           # Alveja um número de PR específico

Isso faz upload das capturas de tela e vídeo para o GitHub e publica um comentário formatado no PR. Por padrão, usa a API oficial de conteúdo do GitHub em uma branch chamada proofshot-artifacts. Use --upload-provider github-web-attachments se você quiser especificamente URLs de anexos do GitHub.

Dicas

  • Sempre inclua uma --description significativa para que o humano saiba o que foi testado
  • Tire capturas de tela ANTES e DEPOIS de ações chave (por exemplo, antes de enviar formulário, após redirecionamento)
  • Se encontrar erros durante a verificação, corrija-os e reexecute o fluxo de trabalho
  • Use proofshot pr após parar para anexar a prova diretamente ao pull request

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Habilidades Relacionadas