Changelog Discipline
Changelog tracciabili fino ai commit reali — i breaking change non vengono mai sepolti o persi
Promosso
Cosa fa
Impone disciplina di onestà nella generazione dei changelog: ogni voce deve essere tracciabile fino a un commit o una PR reali, i breaking change vengono cercati attivamente e messi in cima, e nulla viene inventato o gonfiato. Produce un formato Keep a Changelog rigoroso, al posto della prosa poco strutturata a cui gli agenti tendono di default senza istruzioni precise. Confrontato con una baseline senza skill su quattro repo OSS reali, con vittorie e sconfitte pubblicate per intero.
Rapporto di test
Skill nostro — testato con lo stesso protocollo, dichiarato apertamente. Confrontato testa a testa su 4 intervalli di release di repo OSS reali (Django, Tailwind CSS, FastAPI, curl): sulla fabbricazione pareggio 0-0 per entrambi i rami (nessuno dei due ha inventato voci, versioni, date o citazioni), ma lo skill ha vinto nettamente sulla conformità al formato Keep a Changelog (30/36 contro 13/36) e sul posizionamento dei breaking change in cima (4/4 intervalli contro 0/4), oltre a grandi miglioramenti nella copertura di commit tracciabili (per esempio Django 58% contro 6%, Tailwind 87% contro 0%). La baseline ha vinto la preferenza cieca di leggibilità sui due repo più grandi e rumorosi (curl, Django) e ha superato lo skill sulla copertura tracciabile di FastAPI citando commit interni che lo skill aveva correttamente escluso — un risultato davvero misto, pubblicato per intero comprese le sconfitte. Il test di protocollo ha trovato problemi reali nei nostri stessi repo (link ai benchmark morti, frontmatter YAML troppo rigido) — corretti e riverificati lo stesso giorno.
Testato il: 2026-07-11 · Claude Code 2.x (agent harness)
Installazione
git clone https://github.com/Skillproofdev/changelog-discipline ~/.claude/skills/changelog-discipline
Comandi e prompt di esempio
/changelog-disciplineChangelog tracciabili fino ai commit reali — i breaking change non vengono mai sepolti o persi
Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):
Write release notes for v2.3.0 based on the commits since v2.2.0Update CHANGELOG.md with everything that changed since the last releaseWhat changed between the v1.4 and v2.0 tags? I need to draft a release announcement from the commit history