HomeCasa Prompts

Mensagem de commit e descrição de pull request a partir de um diff

Gere uma mensagem de commit clara (Conventional Commits ou formato livre) e uma descrição de PR com contexto, alterações, como testar e riscos, a partir do diff e do ticket. Pensado para ChatGPT, Claude, Gemini e Microsoft Copilot. Inclui 4 variáveis personalizáveis e pode copiá-lo gratuitamente com um clique.

Iniciante · Texto · Pendente de revisão editorial

Pensado para:

Prompt

Atua como programador sénior que mantém um histórico Git limpo e escreve pull requests fáceis de rever.

Contexto:
- Diff ou lista de alterações:
```diff
{{diff}}
```
- Ticket ou motivo da alteração: {{motivo}}
- Convenção de commits: {{convencao}}
- Quem vai rever o PR: {{revisores}}

Entregáveis:
1. Mensagem de commit:
   - Linha de assunto no imperativo, idealmente com 50 caracteres e nunca mais de 72, com tipo e âmbito se a convenção for Conventional Commits (feat, fix, refactor, docs, test, chore…).
   - Uma linha em branco e depois um corpo que explique porque se fez a alteração, não só o quê, com linhas de no máximo 72 caracteres.
   - Um rodapé com a referência do ticket e «BREAKING CHANGE:» se quebrar compatibilidade.
2. Se o diff misturar alterações independentes, propõe como dividi-lo em vários commits e escreve a mensagem de cada um.
3. Descrição do pull request em Markdown com: Resumo, Contexto e motivação, Principais alterações (lista), Como testar (passos reproduzíveis), Capturas ou evidências, Riscos e plano de reversão, Checklist (testes, documentação, migrações).
4. Dois ou três pontos a que os revisores devem prestar atenção especial.

Restrições:
- Descreve apenas o que aparece no diff. Não afirmes que foram corridos testes ou medido o desempenho: usa [PREENCHER: resultado dos testes].
- Nada de frases vazias como «várias melhorias» ou «pequenas correções».
- Se o motivo da alteração não se deduzir do diff nem do ticket, pergunta-me primeiro.

Formato: um bloco de texto para o commit e um bloco Markdown para o PR.

Como utilizar

Corre git diff --staged (ou git diff main...o-teu-branch) e cola o resultado. Copia o assunto e o corpo para o git commit e a descrição para o formulário do PR, juntando os resultados reais dos testes.

Exemplo de utilização

Diff: novo endpoint de exportação CSV e respetivo teste · Motivo: ticket SHOP-412, a equipa comercial precisa de exportar encomendas · Convenção: Conventional Commits · Revisores: equipa de backend.

Exemplo de resultado

Partindo do princípio de que o diff acrescenta uma parte em texto simples ao email de recuperação e corrige o cabeçalho From…

1. Mensagem de commit

fix(auth): enviar o email de recuperação como multipart com texto

Os filtros do Outlook retinham o email de recuperação da palavra-passe
porque só tinha parte HTML e o remetente não coincidia com o domínio que
assina o envio. Acrescenta uma versão text/plain gerada a partir do mesmo
template e usa o endereço configurado em MAIL_FROM_ADDRESS.

Refs: JIRA-218

3. Descrição da PR

Resumo Corrige a entrega do email de recuperação da palavra-passe aos utilizadores do Outlook (JIRA-218).

Principais alterações

  • Template password-reset com versão HTML e texto simples.
  • Remetente lido da configuração, deixando de estar fixo no código.

Como testar

  1. Pede uma recuperação com uma conta Outlook de testes.
  2. Confirma que chega à caixa de entrada e que o link funciona.

Evidências: [COMPLETAR: resultados dos testes]

Riscos e rollback: afeta apenas este email; reverter o commit repõe o comportamento anterior.

4. Onde olhar com atenção

  • Que a versão em texto não exponha o token fora do link…

Dados-chave

Categoria
Programação e desenvolvimento · Documentação
Tipo de resultado
Texto
Nível
Iniciante
Pensado para
ChatGPT, Claude, Gemini e Microsoft Copilot
Verificado em
Pendente de verificação editorial
Variáveis
Diff, Ticket ou motivo, Convenção e Revisores
Idioma
Português
Preço
Gratuito, sem registo
Atualizado
07/11/2026

Perguntas frequentes

O que é Conventional Commits?

Uma convenção para mensagens de commit no formato tipo(âmbito): descrição. Torna o histórico legível e permite gerar changelogs e versões automaticamente.

Porquê explicar o porquê no corpo?

Porque o quê já está no diff. Daqui a uns meses, quem ler o git blame vai precisar de saber que problema a alteração resolvia e que alternativas foram postas de lado.

Para que serve este prompt?

Gere uma mensagem de commit clara (Conventional Commits ou formato livre) e uma descrição de PR com contexto, alterações, como testar e riscos, a partir do diff e do ticket.

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 (Diff, Ticket ou motivo, Convenção e Revisores). 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?

Não. É um prompt de nível iniciante: basta preencher os dados e colá-lo na sua ferramenta de IA.

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