HomeCasa Prompts

Changelog e note di rilascio a partire dall’elenco dei commit

Trasforma un elenco di commit o PR in un changelog in formato Keep a Changelog, con proposta di versione SemVer, modifiche incompatibili, guida alla migrazione e note leggibili. Pensato per ChatGPT, Claude, Gemini e Microsoft Copilot. Include 5 variabili personalizzabili e puoi copiarlo gratuitamente con un clic.

Principiante · Testo · In attesa di revisione editoriale

Pensato per:

Prompt

Agisci come release manager che scrive changelog precisi e note di rilascio comprensibili.

Contesto:
- Prodotto o libreria: {{prodotto}}
- Versione precedente e intervallo di modifiche: {{intervallo}}
- Elenco dei commit o delle PR unite:
```
{{commit}}
```
- Pubblico delle note: {{pubblico}}
- Formato di output: {{formato}}

Consegne:
1. Classifica ogni commit in: Aggiunto, Modificato, Deprecato, Rimosso, Corretto, Sicurezza. Escludi le modifiche interne senza effetto per l'utente (chore, ci, formattazione) ed elencale a parte.
2. Proposta del numero di versione secondo SemVer (major, minor o patch) con motivazione.
3. Voce del changelog nel formato richiesto, con data [DA COMPLETARE: data di rilascio] e link alle PR quando presenti.
4. Sezione in evidenza sulle modifiche incompatibili: cosa smette di funzionare, chi è coinvolto e guida alla migrazione passo passo con codice prima e dopo.
5. Versione per il pubblico indicato: 3-6 novità spiegate attraverso il loro beneficio, con linguaggio semplice se sono utenti finali.
6. Elenco dei commit ambigui da confermare.

Vincoli:
- Non inventare funzionalità o dettagli che non si deducono dai commit. Se un messaggio è poco chiaro, chiedimelo o segnalo con [DA COMPLETARE].
- Scrivi ogni riga dal punto di vista di chi usa il prodotto, non del codice interno.
- Se mancano la versione precedente o il pubblico, chiedimelo prima.

Formato: Markdown pronto da incollare in CHANGELOG.md o nella pagina della release.

Come usarlo

Ottieni l’elenco con git log v1.4.0..HEAD --oneline o dalle PR unite dall’ultima release. Controlla la versione proposta e la sezione sulle modifiche incompatibili prima di pubblicare.

Esempio d'uso

Prodotto: libreria JavaScript di validazione dei form · Intervallo: da v2.3.1 a main · Pubblico: sviluppatori · Formato: Keep a Changelog.

Esempio di risultato

Supponendo un git log che include, tra gli altri, un endpoint per le note di credito, una correzione dell’arrotondamento IVA e la rinomina di customer_id…

2. Versione proposta

2.0.0 (major): rinominare un campo della risposta rompe i client esistenti, anche se le altre modifiche sarebbero minor e patch.

3. Voce del CHANGELOG

[2.0.0] – [DA COMPLETARE: data di rilascio]

Added

  • Endpoint POST /credit-notes per emettere note di credito su una fattura esistente (#212).

Changed

  • BREAKING: il campo customer_id diventa client_id in tutte le risposte (#219).

Fixed

  • Il totale IVA inclusa non differisce più di un centesimo dalla somma delle righe nelle fatture con molte righe (#215).

4. Modifiche incompatibili e migrazione

Chi è coinvolto: qualsiasi integrazione che legge customer_id.

Prima: const id = invoice.customer_id;

Dopo: const id = invoice.client_id;

6. Commit ambigui

  • a3f9c1e wip validation — cambia i dati accettati dall’API? [DA COMPLETARE]
  • 7be20d4 update deps — c’è un aggiornamento di sicurezza da mettere in Security?

Le modifiche interne (chore, ci, formattazione) sono state escluse dalle note…

Dati chiave

Categoria
Programmazione e sviluppo · Documentazione
Tipo di output
Testo
Livello
Principiante
Pensato per
ChatGPT, Claude, Gemini e Microsoft Copilot
Verificato in
In attesa di verifica editoriale
Variabili
Prodotto o libreria, Versione precedente e intervallo, Commit o PR, Pubblico e Formato
Lingua
Italiano
Prezzo
Gratuito, senza registrazione
Aggiornato
07/11/2026

Domande frequenti

Quando devo aumentare la versione major?

Secondo SemVer, quando una modifica rompe la compatibilità con l’API pubblica. Le nuove funzionalità compatibili aumentano la minor e le correzioni la patch.

Che differenza c’è tra changelog e note di rilascio?

Il changelog è un registro tecnico e completo delle modifiche. Le note di rilascio selezionano le più rilevanti e le spiegano in base al beneficio per il pubblico di quella release.

A cosa serve questo prompt?

Trasforma un elenco di commit o PR in un changelog in formato Keep a Changelog, con proposta di versione SemVer, modifiche incompatibili, guida alla migrazione e note leggibili.

Con quali strumenti di IA funziona?

È pensato per ChatGPT, Claude, Gemini e Microsoft Copilot. Non lo abbiamo ancora verificato in questi strumenti, quindi i risultati possono variare da uno all'altro.

Come personalizzo il prompt?

Clicca su «Personalizza» e compila le variabili (Prodotto o libreria, Versione precedente e intervallo, Commit o PR, Pubblico e Formato). Il testo si aggiorna all'istante e poi puoi copiarlo con un clic. I valori vengono salvati solo nel tuo browser.

Serve esperienza per usarlo?

No. È un prompt di livello principiante: basta compilare i dettagli e incollarlo nel tuo strumento di IA.

Questo prompt è gratuito?

Sì. Tutti i prompt di HomeCasa Prompts sono gratuiti, senza registrazione né abbonamento. Puoi usarli anche in progetti professionali.

Posso fidarmi dell'output dell'IA?

Consideralo una bozza di alta qualità: verifica sempre dati, cifre e affermazioni importanti prima di pubblicare o prendere decisioni.

Prompt correlati