Push
Änderungen committen und auf den aktuellen Branch pushen.
Dieses Skill ist nicht auf einen bestimmten Branch beschränkt – es arbeitet immer auf dem aktuell ausgecheckten Branch. Passen Sie die Trailer-Zeile in Schritt 8 unten an die Commit-Zuschreibungskonvention Ihres Projekts an.
Schnellstart
- Den aktuellen Branch mit
git branch --show-currentermitteln. - Wenn kein aktueller Branch-Name vorhanden ist, abbrechen und den Fehler melden.
- Die neueste Version von
origin/<current-branch>mitgit pull --ff-only origin <current-branch>ziehen. Falls dies fehlschlägt, abbrechen und den Fehler melden. - Den Diff vor dem Staging inspizieren.
- Bei Relevanz den neuesten aussagekräftigen Eintrag in
docs/change-log.mdals Quelle für die Commit-Nachricht bevorzugen. - Wenn kein Change-Log-Eintrag die tatsächliche Quelle der Änderung ist, die Nachricht aus dem primär geänderten Bereich im Diff ableiten.
- Alle Änderungen mit
git add -Astagen. - Mit einer mehrzeiligen Nachricht committen und den projektspezifischen Standard-Trailer anhängen (normalerweise eine
Co-Authored-By:-Zeile oder eine ähnliche Zuschreibung; projektspezifisch). - Mit
git push origin <current-branch>pushen. - Branch, Commit-Hash und Betreff in einem Satz melden.
Hinweise zur Commit-Nachricht
Verwenden Sie einen prägnanten Betreff im konventionellen Stil, z. B.:
docs:für Dokumentation oder Routing-Änderungenfeat:für neue Fähigkeiten, Systeme oder Inhaltefix:für Verhaltenskorrekturenrefactor:für strukturelle Änderungen ohne wesentliche Verhaltensänderungtest:für sinnvolle Erweiterungen oder Überarbeitungen der Testabdeckungchore:für Wartungsarbeiten, die nicht besser in eine andere Kategorie passen
Für den Textkörper:
- die wichtigsten geänderten Bereiche zusammenfassen
- pro wesentliche Änderung eine Zeile bevorzugen
- am tatsächlichen Diff orientiert bleiben
Wenn docs/change-log.md als Quelle verwendet wird:
- den neuesten aussagekräftigen Abschnitt oder Eintrag bevorzugen, der die zentrale Änderung tatsächlich beschreibt
- keine aus dem Change-Log abgeleitete Nachricht erzwingen, wenn das Change-Log-Update nebensächlich ist
Wenn das Change-Log nicht als Quelle verwendet wird:
- den Betreff aus dem wichtigsten geänderten Bereich im Diff ableiten
- wenn der Diff zu mehrdeutig für eine sichere Zusammenfassung ist, den Benutzer stattdessen nach der Commit-Nachricht fragen
Regeln
- Immer den aktuell ausgecheckten Branch verwenden.
- Niemals
--forceoder--force-with-leaseverwenden. - Niemals
--no-verifyverwenden. - Laut scheitern: Wenn ein Schritt fehlschlägt, abbrechen und den Fehler melden.