HomeCasa Prompts

Code review de um pull request com checklist e comentários por gravidade

Reveja um diff como um revisor sénior: checklist de correção, segurança, desempenho e legibilidade, comentários ordenados por gravidade e um veredicto claro de aprovar ou pedir alterações. Pensado para ChatGPT, Claude, Gemini e Microsoft Copilot. Inclui 5 variáveis personalizáveis e pode copiá-lo gratuitamente com um clique.

Intermédio · Código · Pendente de revisão editorial

Pensado para:

Prompt

Atua como revisor de código sénior que deixa comentários úteis, concretos e respeitosos.

Contexto:
- Stack do projeto: {{stack}}
- Objetivo do pull request: {{objetivo_pr}}
- Foco da revisão: {{foco}}
- Convenções da equipa: {{convencoes}}
- Diff:
```diff
{{diff}}
```

Entregáveis:
1. Resumo em 2-3 frases do que o PR muda realmente e se cumpre o objetivo.
2. Checklist aplicada ao diff, marcando cada ponto como OK, rever ou não se aplica: correção e casos limite, tratamento de erros, segurança (entradas, permissões, segredos), desempenho (consultas N+1, ciclos, memória), concorrência, testes, legibilidade e nomes, retrocompatibilidade, migrações e configuração.
3. Comentários de revisão neste formato: ficheiro e linha, gravidade (bloqueante, importante, menor, pormenor), problema, porque importa e sugestão de código.
4. Perguntas ao autor quando a intenção não for clara, em vez de supor.
5. O que está bem feito (2-3 pontos concretos).
6. Veredicto: aprovar, aprovar com comentários ou pedir alterações, com a lista mínima do que tem de mudar para aprovar.

Restrições:
- Comenta apenas linhas que aparecem no diff; se algo depender de código que não mostrei, marca como [PREENCHER: verificar fora do diff].
- Não transformes preferências pessoais em bloqueantes; respeita as convenções da equipa.
- Tom construtivo: descreve o código, não a pessoa.
- Se o diff estiver incompleto ou faltar o objetivo, pergunta-me primeiro.

Formato: secções numeradas, checklist em tabela e comentários agrupados por ficheiro.

Como utilizar

Copia o diff com git diff main...o-teu-branch ou a partir da vista de alterações do PR. Em PR grandes, revê grupos de ficheiros relacionados em separado e cola os comentários úteis diretamente na plataforma Git.

Exemplo de utilização

Stack: Django 5 e PostgreSQL · Objetivo: exportar encomendas para CSV · Foco: revisão completa · Convenções: PEP 8, testes obrigatórios nos serviços.

Exemplo de resultado

Partindo do princípio de que o diff acrescenta a rota POST /conta/subscricao/cancelar com a lógica no SubscriptionController…

1. Resumo

A PR permite cancelar na conta e marca a subscrição como cancelada, mas a lógica está no controlador e nada verifica se a subscrição pertence ao utilizador.

2. Checklist (excerto)

PontoEstado
Correção e casos-limiteRever: e se já estiver cancelada?
Segurança / permissõesRever
TestesRever: falta o teste do serviço
MigraçõesN/A

3. Comentários

app/Http/Controllers/SubscriptionController.php L42 · bloqueante Qualquer utilizador autenticado consegue cancelar a subscrição de outro mudando o id, e a lógica viola a convenção «sem lógica nos controladores». Sugestão:

public function cancel(Subscription $subscription, CancelSubscription $action): RedirectResponse
{
    Gate::authorize('cancel', $subscription);   // a Policy verifica o dono

    $action->handle($subscription);             // serviço com o seu próprio teste

    return back()->with('status', __('subscriptions.cancelled'));
}

Pergunta ao autor: o cancelamento é imediato ou no fim do período faturado? [COMPLETAR: verificar fora do diff]

6. Veredicto

Pedir alterações: Policy com teste de 403 e lógica movida para CancelSubscription…

Dados-chave

Categoria
Programação e desenvolvimento · Refatorização
Tipo de resultado
Código
Nível
Intermédio
Pensado para
ChatGPT, Claude, Gemini e Microsoft Copilot
Verificado em
Pendente de verificação editorial
Variáveis
Stack do projeto, Objetivo do PR, Foco, Convenções da equipa e Diff
Idioma
Português
Preço
Gratuito, sem registo
Atualizado
07/11/2026

Perguntas frequentes

Esta revisão substitui a de um colega?

Não. Ajuda a apanhar problemas antes de pedir revisão ou serve de segunda opinião, mas o conhecimento do domínio e do contexto da equipa continua a vir de uma pessoa.

O que faço com um diff de milhares de linhas?

Divide-o por áreas (modelo, API, interface) e revê cada parte em separado com o mesmo objetivo. Se possível, pede ao autor que divida o PR em alterações mais pequenas.

Para que serve este prompt?

Reveja um diff como um revisor sénior: checklist de correção, segurança, desempenho e legibilidade, comentários ordenados por gravidade e um veredicto claro de aprovar ou pedir alterações.

Com que ferramentas de IA funciona?

Foi pensado para ChatGPT, Claude, Gemini e Microsoft Copilot. Ainda não o verificámos nestas ferramentas, pelo que os resultados podem variar entre elas.

Como personalizo o prompt?

Clique em “Personalizar” e preencha as variáveis (Stack do projeto, Objetivo do PR, Foco, Convenções da equipa e Diff). O texto atualiza-se instantaneamente e pode depois copiá-lo com um clique. Os valores ficam guardados apenas no seu navegador.

Preciso de experiência para o utilizar?

É de nível intermédio: convém conhecer o tema para fornecer bom contexto e rever o resultado com sentido crítico.

Este prompt é gratuito?

Sim. Todos os prompts do HomeCasa Prompts são gratuitos, sem registo nem subscrição. Pode também utilizá-los em projetos profissionais.

Posso confiar no resultado da IA?

Trate-o como um rascunho de qualidade: verifique sempre os dados, os números e as afirmações importantes antes de publicar ou tomar decisões.

Prompts relacionados