Changelog Discipline

Endringslogger som spores til ekte commits — breaking changes blir aldri gjemt bort eller utelatt

av SkillProof · Skillproofdev/changelog-discipline

Bestått ★ 8.0/10

Changelog Discipline — Endringslogger som spores til ekte commits — breaking changes blir aldri gjemt bort eller utelatt

Hva den gjør

Håndhever ærlighetsdisiplin ved generering av endringslogger: hver linje må spores til en ekte commit eller PR, breaking changes blir aktivt jaktet på og plassert først, og ingenting dikts opp eller fylles ut. Gir streng Keep-a-Changelog-formatering i stedet for den løst strukturerte teksten agenter faller tilbake på uten instruks. Benchmarket mot en baseline uten skill på fire ekte OSS-repoer, med både seire og tap publisert i sin helhet.

Testrapport

Vår egen skill — testet under samme protokoll, avslørt. Benchmarket direkte mot en baseline uten skill over 4 ekte OSS-utgivelsesintervaller (Django, Tailwind CSS, FastAPI, curl): oppdiktning endte 0-0 for begge armer (ingen av dem fant opp linjer, versjoner, datoer eller kilder), men skillen vant klart på Keep-a-Changelog-formatoverholdelse (30/36 mot 13/36) og på å plassere breaking changes først (4/4 intervaller mot 0/4), i tillegg til store gevinster i sporbar commit-dekning (f.eks. Django 58 % mot 6 %, Tailwind 87 % mot 0 %). Baseline vant den blinde lesbarhetspreferansen på de to største/mest støyete repoene (curl, Django) og slo skillen så vidt på FastAPIs sporbare dekning ved å sitere interne commits skillen med rette utelot — et genuint blandet resultat, publisert i sin helhet inkludert tapene. Protokolltesten avdekket reelle problemer i våre egne repoer (døde benchmark-lenker, streng YAML-frontmatter) — fikset og reverifisert samme dag.

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

Installer

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

Kommandoer og eksempelprompter

  • /changelog-disciplineEndringslogger som spores til ekte commits — breaking changes blir aldri gjemt bort eller utelatt

Skills utløses av vanlige forespørsler — ingen kommandoer å huske. Etter installasjonen 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