Changelog Discipline

Changelogs, der kan spores til rigtige commits — breaking changes bliver aldrig gemt væk eller udeladt

Af SkillProof · Skillproofdev/changelog-discipline

Testet · Virker ★ 8.0/10

Changelog Discipline — Changelogs, der kan spores til rigtige commits — breaking changes bliver aldrig gemt væk eller udeladt

Hvad det gør

Håndhæver ærlighedsdisciplin ved generering af changelogs: hver linje skal kunne spores til en rigtig commit eller PR, breaking changes bliver aktivt opsporet og placeret først, og intet bliver opfundet eller polstret. Output følger streng Keep-a-Changelog-formatering i stedet for den løst strukturerede prosa, agenter ellers falder tilbage på uden instruktion. Benchmarket mod en baseline uden skill på fire rigtige open source-repos, hvor både sejre og nederlag er offentliggjort i sin helhed.

Testrapport

Vores eget skill — testet efter samme protokol, og det oplyser vi åbent. Benchmarket direkte mod en baseline uden skill på tværs af 4 rigtige OSS-udgivelsesintervaller (Django, Tailwind CSS, FastAPI, curl): opdigtning endte 0-0 for begge sider (ingen af dem opfandt linjer, versioner, datoer eller kilder), men skillet vandt klart på overholdelse af Keep-a-Changelog-formatet (30/36 mod 13/36) og på at placere breaking changes først (4/4 intervaller mod 0/4), samt store gevinster i sporbar commit-dækning (f.eks. Django 58% mod 6%, Tailwind 87% mod 0%). Baseline vandt den blinde læsbarhedspræference på de to største/støjende repos (curl, Django) og slog skillet en anelse på FastAPIs sporbare dækning ved at citere interne commits, som skillet korrekt havde udeladt — et reelt blandet resultat, offentliggjort i sin helhed inklusive nederlagene. Protokoltesten fangede reelle problemer i vores egne repos (døde benchmark-links, striks YAML-frontmatter) — rettet og genverificeret samme dag.

Testet: 2026-07-11 · Claude Code 2.x (agent harness)

Installation

git clone https://github.com/Skillproofdev/changelog-discipline ~/.claude/skills/changelog-discipline

Kommandoer og eksempelprompter

  • /changelog-disciplineChangelogs, der kan spores til rigtige commits — breaking changes bliver aldrig gemt væk eller udeladt

Skills udløses af almindelige forespørgsler — ingen kommandoer at huske. Efter installationen aktiverer prompter som disse skillen (på engelsk):

  • Write release notes for v2.3.0 based on the commits since v2.2.0
  • Update CHANGELOG.md with everything that changed since the last release
  • What changed between the v1.4 and v2.0 tags? I need to draft a release announcement from the commit history