HomeCasa Prompts

Changelog e notas de versão a partir da lista de commits

Transforme uma lista de commits ou PR num changelog no formato Keep a Changelog, com proposta de versão SemVer, alterações incompatíveis, guia de migração e notas fáceis de ler. Pensado para ChatGPT, Claude, Gemini e Microsoft Copilot. Inclui 5 variáveis personalizáveis e pode copiá-lo gratuitamente com um clique.

Iniciante · Texto · Pendente de revisão editorial

Pensado para:

Prompt

Atua como responsável de releases que escreve changelogs rigorosos e notas de versão fáceis de perceber.

Contexto:
- Produto ou biblioteca: {{produto}}
- Versão anterior e intervalo de alterações: {{intervalo}}
- Lista de commits ou PR integrados:
```
{{commits}}
```
- Público das notas: {{publico}}
- Formato de saída: {{formato}}

Entregáveis:
1. Classifica cada commit em: Adicionado, Alterado, Obsoleto, Removido, Corrigido, Segurança. Exclui alterações internas sem efeito para o utilizador (chore, ci, formatação) e lista-as à parte.
2. Proposta de número de versão segundo SemVer (major, minor ou patch) com justificação.
3. Entrada do changelog no formato pedido, com data [PREENCHER: data de publicação] e ligações para os PR quando existirem.
4. Secção em destaque com as alterações incompatíveis: o que deixa de funcionar, a quem afeta e guia de migração passo a passo com código antes e depois.
5. Versão para o público indicado: 3 a 6 novidades explicadas pelo seu benefício, em linguagem simples se forem utilizadores finais.
6. Lista dos commits ambíguos que precisam de confirmação.

Restrições:
- Não inventes funcionalidades nem detalhes que não se deduzam dos commits. Se uma mensagem for pouco clara, pergunta-me ou marca como [PREENCHER].
- Escreve cada linha do ponto de vista de quem usa o produto, não do código interno.
- Se faltar a versão anterior ou o público, pergunta-me primeiro.

Formato: Markdown pronto a colar no CHANGELOG.md ou na página da release.

Como utilizar

Obtém a lista com git log v1.4.0..HEAD --oneline ou a partir dos PR integrados desde a última release. Revê a versão proposta e a secção de alterações incompatíveis antes de publicar.

Exemplo de utilização

Produto: biblioteca JavaScript de validação de formulários · Intervalo: de v2.3.1 até main · Público: programadores · Formato: Keep a Changelog.

Exemplo de resultado

Partindo de um git log que inclui, entre outros, um endpoint de notas de crédito, uma correção do arredondamento do IVA e a mudança de nome de customer_id…

2. Versão proposta

2.0.0 (major): mudar o nome de um campo da resposta parte os clientes existentes, ainda que as restantes alterações fossem minor e patch.

3. Entrada do CHANGELOG

[2.0.0] – [COMPLETAR: data de lançamento]

Added

  • Endpoint POST /credit-notes para emitir notas de crédito sobre uma fatura existente (#212).

Changed

  • BREAKING: o campo customer_id passa a chamar-se client_id em todas as respostas (#219).

Fixed

  • Em faturas com muitas linhas, o total com IVA já não difere um cêntimo da soma das linhas (#215).

4. Alterações incompatíveis e migração

Afeta: qualquer integração que leia customer_id.

Antes: const id = invoice.customer_id;

Depois: const id = invoice.client_id;

6. Commits ambíguos

  • a3f9c1e wip validation — altera os dados que a API aceita? [COMPLETAR]
  • 7be20d4 update deps — inclui alguma atualização de segurança para Security?

As alterações internas (chore, ci, formatação) ficaram fora das notas…

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
Produto ou biblioteca, Versão anterior e intervalo, Commits ou PR, Público e Formato
Idioma
Português
Preço
Gratuito, sem registo
Atualizado
07/11/2026

Perguntas frequentes

Quando devo subir a versão major?

Segundo o SemVer, quando uma alteração quebra a compatibilidade da API pública. Funcionalidades novas compatíveis sobem a minor e as correções sobem o patch.

Qual é a diferença entre changelog e notas de versão?

O changelog é um registo técnico e completo das alterações. As notas de versão escolhem o mais relevante e explicam o benefício para o público dessa release.

Para que serve este prompt?

Transforme uma lista de commits ou PR num changelog no formato Keep a Changelog, com proposta de versão SemVer, alterações incompatíveis, guia de migração e notas fáceis de ler.

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 (Produto ou biblioteca, Versão anterior e intervalo, Commits ou PR, Público e Formato). 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