Changelog Discipline
Changelogi oparte na realnych commitach — zmiany łamiące kompatybilność nigdy nie giną ani nie są ukrywane.
Testowano · Działa
Co robi ten skill
Wymusza rzetelność przy generowaniu changelogów: każdy wpis musi dać się powiązać z realnym commitem lub PR-em, zmiany łamiące kompatybilność są aktywnie wyszukiwane i umieszczane na początku, a nic nie jest zmyślane ani sztucznie rozdmuchiwane. Wynikiem jest ścisłe formatowanie zgodne z Keep a Changelog, zamiast luźno ustrukturyzowanej prozy, jaką agenty produkują domyślnie bez dodatkowych wskazówek. Zbenchmarkowane względem agenta bez skilla na czterech realnych repozytoriach open source, z opublikowanymi w całości zarówno wygranymi, jak i przegranymi.
Raport z testu
Nasz własny skill — testowany według tego samego protokołu, jawnie to zaznaczamy. Zbenchmarkowany bezpośrednio przeciwko agentowi bez skilla na 4 realnych zakresach wydań open source (Django, Tailwind CSS, FastAPI, curl): pod względem zmyślania wynik 0-0 dla obu wariantów (żaden nie wymyślił wpisów, wersji, dat ani odniesień), ale skill wyraźnie wygrał zgodność formatu z Keep a Changelog (30/36 vs 13/36) i umieszczanie zmian łamiących kompatybilność na początku (4/4 zakresy vs 0/4), a do tego znacząco lepsze pokrycie wpisów realnymi commitami (np. Django 58% vs 6%, Tailwind 87% vs 0%). Wariant bazowy wygrał ślepy test czytelności na dwóch największych i najbardziej chaotycznych repozytoriach (curl, Django) i minimalnie przebił skill w pokryciu commitów dla FastAPI, cytując commity wewnętrzne, które skill słusznie pominął — wynik naprawdę mieszany, opublikowany w całości razem z przegranymi. Test protokołu wykrył realne problemy w naszych własnych repozytoriach (martwe linki do benchmarków, zbyt rygorystyczny YAML frontmatter) — naprawione i ponownie zweryfikowane tego samego dnia.
Testowano: 2026-07-11 · Claude Code 2.x (agent harness)
Instalacja
git clone https://github.com/Skillproofdev/changelog-discipline ~/.claude/skills/changelog-discipline
Komendy i przykładowe prompty
/changelog-disciplineChangelogi oparte na realnych commitach — zmiany łamiące kompatybilność nigdy nie giną ani nie są ukrywane.
Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):
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