Changelog Discipline

Ändringsloggar som går att spåra till riktiga commits — breaking changes begravs eller försvinner aldrig

av SkillProof · Skillproofdev/changelog-discipline

Testad · Fungerar ★ 8.0/10

Changelog Discipline — Ändringsloggar som går att spåra till riktiga commits — breaking changes begravs eller försvinner aldrig

Vad den gör

Upprätthåller ärlighetsdisciplin vid generering av ändringsloggar: varje rad måste spåras till en riktig commit eller PR, breaking changes jagas aktivt fram och placeras överst, och inget hittas på eller fylls ut i onödan. Ger strikt Keep-a-Changelog-formatering i stället för den löst strukturerade prosa agenter annars faller tillbaka på. Benchmarkad mot en baslinje utan skill på fyra riktiga OSS-repos, med både vinster och förluster publicerade i sin helhet.

Testrapport

Vår egen skill — testad enligt samma protokoll, öppet redovisat. Benchmarkad direkt mot en baslinje utan skill över 4 riktiga OSS-releaseintervall (Django, Tailwind CSS, FastAPI, curl): påhitt låg lika, 0-0, för båda sidorna (ingen hittade på rader, versioner, datum eller källor), men skillen vann klart på Keep-a-Changelog-formatering (30/36 mot 13/36) och på att placera breaking changes överst (4/4 intervall mot 0/4), plus stora förbättringar i spårbar commit-täckning (till exempel Django 58 % mot 6 %, Tailwind 87 % mot 0 %). Baslinjen vann den blinda läsbarhetspreferensen på de två största och stökigaste repona (curl, Django) och gick om skillen något på FastAPI:s spårbara täckning genom att citera interna commits som skillen korrekt uteslöt — ett genuint blandat resultat, publicerat i sin helhet inklusive förlusterna. Protokolltestet hittade verkliga problem i våra egna repos (döda benchmark-länkar, sträng YAML-frontmatter) — åtgärdat och verifierat på nytt samma dag.

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

Installation

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

Kommandon och exempelprompter

  • /changelog-disciplineÄndringsloggar som går att spåra till riktiga commits — breaking changes begravs eller försvinner aldrig

Skills triggas av vanliga förfrågningar — inga kommandon att memorera. Efter installationen aktiverar prompter som dessa skillen (på engelska):

  • 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