AppReviewX Entrar

Modelo de prompt: do relatório do testador à correção

Um prompt pronto para copiar, com passos, aparelho, resultado esperado e uma verificação de regressão.

Neste guia

Cole o relatório de um testador neste prompt, preencha os colchetes e envie para o seu assistente de programação. Um relatório por prompt. O modelo funciona com qualquer assistente porque descreve apenas o problema, os limites e a verificação.

O modelo

Tenho um bug no meu app, relatado por um testador. Por favor, me ajude a corrigi-lo.

CONTEXTO
App: [uma frase: o que o app faz]
Tela / funcionalidade: [onde o bug acontece]
Plataforma: [Android / iOS / ambos]

RELATÓRIO
Passos:
1. [passo]
2. [passo]
3. [passo]
Esperado: [o que deveria acontecer]
Real: [o que acontece]
Aparelho e versão do sistema: [ex.: modelo, versão do sistema]
Extra (texto de erro, descrição de captura de tela, logs): [cole ou escreva "nenhum"]

ANTES DE MUDAR QUALQUER COISA
- Diga em 2 a 3 frases qual parte do código você acha que causa isso e por quê.
- Se não tiver certeza, diga isso e liste o que precisaria ver.

RESTRIÇÕES
- Altere somente o necessário para este bug. Não refatore nem renomeie código não relacionado.
- Não adicione novas bibliotecas sem antes explicar o motivo.
- Liste cada arquivo que você alterar e o que mudou em cada um.

VERIFICAÇÃO DE REGRESSÃO
- Isto precisa continuar funcionando: [um comportamento próximo]
- Me dê um teste manual curto que eu possa fazer em um celular: passos exatos e o resultado esperado, para o bug e para a linha acima.

Exemplo preenchido

Este é um exemplo, não um relatório real.

Tenho um bug no meu app, relatado por um testador. Por favor, me ajude a corrigi-lo.

CONTEXTO
App: Um app de lista de compras em que você pode compartilhar uma lista com a família.
Tela / funcionalidade: Adicionar um item na tela da lista
Plataforma: Android

RELATÓRIO
Passos:
1. Abrir uma lista existente
2. Tocar em "Adicionar item" e digitar "leite"
3. Fechar o teclado com o botão voltar
Esperado: "leite" aparece na lista
Real: o item não é salvo e o campo fica vazio de novo
Aparelho e versão do sistema: Celular de exemplo, Android 14
Extra: nenhuma mensagem de erro exibida

ANTES DE MUDAR QUALQUER COISA
- Diga em 2 a 3 frases qual parte do código você acha que causa isso e por quê.
- Se não tiver certeza, diga isso e liste o que precisaria ver.

RESTRIÇÕES
- Altere somente o necessário para este bug. ...

VERIFICAÇÃO DE REGRESSÃO
- Isto precisa continuar funcionando: adicionar um item com a tecla "Concluído" do teclado
- Me dê um teste manual curto ...

Como adaptar

  • Não consegue reproduzir? Substitua "Passos" pelo que o testador escreveu e acrescente: "Não consegui reproduzir isto. Sugira o que registrar para eu capturar o problema."
  • Crash com stack trace? Cole o trace em "Extra" e mantenha-o curto; as primeiras linhas costumam ser as mais importantes.
  • Problema de interface? Descreva o tamanho da tela e o layout em vez de termos de código, e diga o que você vê versus o que quer.
  • Vários relatórios? Não os junte. Execute o modelo uma vez por relatório, em ordem de impacto.

Depois da resposta

Leia a lista de arquivos alterados, execute o teste manual em um celular real e depois verifique a linha "precisa continuar funcionando". Se falhar, volte com o que você observou. Para a rotina completa, veja o ciclo de feedback com seu assistente de programação.

Precisa de um bom relatório para começar? Use o modelo de relatório de bug para testadores.

Relacionados: hub de vibe coding, testes em aparelhos reais, como testar um app antes do lançamento.

O AppReviewX oferece feedback privado e estruturado de outros desenvolvedores (cada feedback que você escrever rende um crédito; contas novas começam com 0). Comece grátis.