Conventional Commits: maschinenlesbare Commit-Typen

Worum es geht

Conventional Commits ist eine schlanke Konvention für Commit-Nachrichten: type(optional scope)!: description, gefolgt von einem optionalen Body und Footern. Die Spezifikation definiert fix für Fehlerbehebungen und feat für neue Funktionen; andere Typen wie docs, refactor, test oder chore sind zulässig, werden aber von der Spezifikation selbst nicht standardisiert.

Warum es wichtig ist

Die Konvention gibt Werkzeugen ein verlässliches Signal. Ein fix entspricht unter Semantic Versioning einem Patch-Release, ein feat einem Minor-Release, und ein BREAKING CHANGE:-Footer oder ein ! nach dem Typ einem Major-Release. Changelogs, Release Notes und Versionssprünge lassen sich dann aus der Historie generieren, statt von Hand geschrieben zu werden.

So wird es angewendet

• Sich auf die zulässigen Typen und Scopes einigen und die Liste kurz halten.
• Die für Menschen verständliche Erklärung wie bei jeder guten Commit-Nachricht in den Body schreiben; das Präfix klassifiziert nur.
• Breaking Changes ausdrücklich markieren und die Migration im Footer beschreiben.
• Die Form erst per Commit-Hook oder CI-Prüfung erzwingen, nachdem das Team sie eine Weile eingeübt hat.

Stolpersteine

Typisierte Präfixe machen eine Nachricht noch nicht gut; «fix: fix» bleibt inhaltsleer. Squash-Merges müssen das Präfix erhalten oder umschreiben, sonst ist der generierte Changelog falsch. Scopes, die den Verzeichnisbaum spiegeln, werden in kleinen Repositories zu Rauschen.