Arbeitsablauf
- Überprüfe den Repository-Zustand:
git status --short, git diff --cached und git diff. Prüfe auch git log --oneline -10, um den vorhandenen Stil zu übernehmen.
- Wenn nichts gestaged ist, stage die relevanten Änderungen mit explizitem Pfad (vermeide
git add -A, falls nicht zusammenhängende oder sensible Dateien vorhanden sind). Niemals .env, Secrets oder .venv stagen.
- Wenn die Änderungen eindeutig nicht zusammenhängende Belange enthalten, teile sie in separate Commits auf.
- Schreibe die Nachricht nach dem folgenden Format und committe dann mit
git commit.
- Führe
git status aus, um zu überprüfen, ob der Commit erfolgreich war.
- Nur pushen, wenn der Benutzer
--push übergeben hat: führe git push aus (verwende git push -u origin <branch>, wenn kein Upstream gesetzt ist). Niemals force-pushen.
Nachrichtenformat
<typ>(<optionaler bereich>): <beschreibung>
<optionaler body>
<optionaler footer>
- Typen:
feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert.
- Beschreibung: Imperativ, Kleinbuchstaben, kein Punkt am Ende, maximal ~72 Zeichen.
- Bereich (Scope): Kurzes Nomen für den betroffenen Bereich (z. B.
cli, server, translate); weglassen, wenn unklar.
- Body: Erkläre das Warum, umgebrochen bei ~72 Zeichen; bei trivialen Änderungen weglassen.
- Breaking Changes: Füge
! nach Typ/Bereich ein und einen BREAKING CHANGE:-Footer.
Regeln
- Kein Amend, Rebase oder Rewrite der Geschichte, es sei denn, darum gebeten.
- Kein Überspringen von Hooks (
--no-verify).
- Wenn ein Hook fehlschlägt, behebe das Problem und erstelle einen neuen Commit.
- Keinen Commit ausführen, wenn keine Änderungen vorliegen; stattdessen dies mitteilen.