Changelog Discipline
Changelogy podložené reálnými commity — breaking changes se nikdy neztratí ani nezapadnou
Otestováno · Funguje
Co umí
Vynucuje disciplínu poctivosti při generování changelogů: každá položka musí být podložená reálným commitem nebo PR, breaking changes se aktivně vyhledávají a uvádějí jako první a nic se nevymýšlí ani nenafukuje. Výstupem je přísný formát podle Keep a Changelog místo volně strukturované prózy, ke které agenti bez skillu tíhnou sami od sebe. Testováno proti variantě bez skillu na čtyřech reálných OSS repozitářích, výhry i prohry zveřejněné v plném rozsahu.
Testovací report
Náš vlastní skill — testovaný podle stejného protokolu, otevřeně přiznáno. Přímé srovnání proti variantě bez skillu na čtyřech reálných release intervalech z OSS projektů (Django, Tailwind CSS, FastAPI, curl): ve vymýšlení faktů remíza 0:0 na obou stranách (žádná varianta si nevymyslela položku, verzi, datum ani citaci), ale skill jasně vyhrál v dodržení formátu Keep a Changelog (30/36 vs. 13/36) i v umísťování breaking changes na první místo (4/4 intervaly vs. 0/4) a přinesl výrazně vyšší pokrytí dohledatelnými commity (např. Django 58 % vs. 6 %, Tailwind 87 % vs. 0 %). Základní varianta zvítězila v naslepo hodnocené čitelnosti u dvou největších a nejnepřehlednějších repozitářů (curl, Django) a mírně předběhla skill v dohledatelném pokrytí u FastAPI tím, že citovala interní commity, které skill správně vynechal — jde o opravdu smíšený výsledek, zveřejněný v plném rozsahu včetně proher. Test protokolu odhalil reálné problémy v našich vlastních repozitářích (mrtvé odkazy na benchmarky, přísný YAML frontmatter) — opraveno a znovu ověřeno tentýž den.
Testováno: 2026-07-11 · Claude Code 2.x (agent harness)
Instalace
git clone https://github.com/Skillproofdev/changelog-discipline ~/.claude/skills/changelog-discipline
Příkazy a ukázkové prompty
/changelog-disciplineChangelogy podložené reálnými commity — breaking changes se nikdy neztratí ani nezapadnou
Skilly se spouštějí běžnými požadavky — žádné příkazy k zapamatování. Po instalaci ho aktivují prompty jako tyto (anglicky):
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