Promote Changes
Führt den vollständigen Release-Workflow vom aktuellen Arbeitsstand bis zu einem getaggten GitHub-Release auf main aus.
Aktueller Branch: !git branch --show-current 2>/dev/null || echo "unknown"
Git-Status: !git status --short 2>/dev/null || echo "not a git repo"
Letzter Tag: !git describe --tags --abbrev=0 2>/dev/null || echo "none"
Letzte Commits seit dem letzten Tag:
!`git log $(git describe --tags --abbrev=0 2>/dev/null || echo "")..HEAD --oneline -10 2>/dev/null || git log --oneline -10`
Nächste Version (berechnet aus obigen Commits):
!`(last=$(git describe --tags --abbrev=0 2>/dev/null || echo "v0.0.0"); IFS='.' read -r ma mi pa <<< "${last#v}"; log=$(git log "${last}..HEAD" --format="%s" 2>/dev/null); if echo "$log" | grep -qE "^[a-z]+(\([^)]+\))?!:"; then echo "v$((ma+1)).0.0"; elif echo "$log" | grep -qE "^feat"; then echo "v${ma}.$((mi+1)).0"; else echo "v${ma}.${mi}.$((pa+1))"; fi)`
Schritt 0: Vorabprüfungen
gh auth status 2>&1 || { echo "FEHLER: gh ist nicht authentifiziert. Führe aus: gh auth login"; exit 1; }
Prüfung auf ungetrackte .env-Dateien, die versehentlich gestaged werden könnten:
git status --short | grep -E '^\?\? .*\.env' && echo "WARNUNG: ungetrackte .env-Dateien erkannt – vor dem Stagen überprüfen"
cat .gitignore 2>/dev/null | grep -q '\.env' || echo "WARNUNG: .gitignore schließt .env-Dateien nicht aus"
Falls .env-Dateien gestaged würden:
if [ -t 0 ]; then
# Interaktiv – Bestätigung vor Fortsetzung anfordern
read -p "WARNUNG: .env-Dateien erkannt. Fortfahren? (y/N) " confirm
[[ "$confirm" =~ ^[Yy]$ ]] || { echo "Abgebrochen."; exit 1; }
else
# Nicht-interaktiv – harter Stopp; zu riskant ohne menschliche Überprüfung
echo "FEHLER: ungetrackte .env-Dateien im nicht-interaktiven Modus erkannt. Abbruch."
exit 1
fi
Schritt 1: Ausstehende Änderungen committen
Wenn der Git-Status oben uncommittete oder ungetrackte Änderungen anzeigt:
- Diff anzeigen:
git diffundgit diff --cached - Änderungen selektiv stagen – bevorzugt getrackte Dateien:
git add -u, dann überprüfen und ggf. einzelne neue Dateien hinzufügen. Vermeidegit add -A, es sei denn, der Benutzer bestätigt ausdrücklich. - Eine konventionelle Commit-Nachricht aus den Änderungen entwerfen – mit einem Typ-Präfix
(
feat:,fix:,docs:,chore:, usw.) und einer prägnanten Zusammenfassung - Mit einem Here-Document committen, damit mehrzeilige Nachrichten korrekt formatiert werden
Falls nichts uncommittet ist, fahre mit Schritt 2 fort.
Schritt 2: Pushen
Aktuellen Branch zum Remote pushen:
git push -u origin HEAD
Schritt 3: Nach main mergen (nur Feature-Branch)
Diesen Schritt überspringen, wenn bereits auf main (oder dem Standard-Branch des Repos).
Falls auf einem Feature-Branch:
-
Commits seit dem letzten Tag nach Issue-Referenzen durchsuchen:
git log $(git describe --tags --abbrev=0 2>/dev/null || echo "")..HEAD --format="%B"Suche nach
Closes #N,Fixes #N,Resolves #N(Groß-/Kleinschreibung egal). Sammle alle gefundenen Issue-Nummern. Falls keine gefunden:if [ -t 0 ]; then # Interaktiv – Benutzer fragen read -p "GitHub-Issues, die hiermit geschlossen werden? (z. B. 12 15 – oder Enter zum Überspringen) " issues else # Nicht-interaktiv – stillschweigend überspringen issues="" fi -
Einen PR mit Ziel main erstellen, einschließlich Schlüsselwörter zum Schließen im Body, damit GitHub die Issues beim Mergen automatisch schließt:
gh pr create --title "<type>: <summary>" --body "$(cat <<'EOF' ## Zusammenfassung <Aufzählungspunkte aus Commits> Closes #N, Closes #N 🤖 Generiert mit [claude-workflow-skills:promote](https://github.com/ali5ter/claude-workflow-skills) im Auftrag von [Alister](https://github.com/ali5ter) EOF )"Die
Closes-Zeilen weglassen, falls keine Issues identifiziert wurden. -
Auto-Merge aktivieren (Squash bevorzugt):
gh pr merge --auto --squash -
Warten, bis gemerged wurde:
gh pr view --json state --jq '.state' -
Zu main wechseln und pullen:
git checkout main && git pull
Schritt 4: Nächste Version bestätigen
Die nächste Version wird im Kontextblock oben vorberechnet, basierend auf diesen Semver-Regeln:
- Commit-Betreff mit
!:(z. B.feat!:,fix!:) → Major-Sprung - Commit-Betreff, der mit
featbeginnt → Minor-Sprung - Alle anderen Commits → Patch-Sprung
Bestätige, dass die berechnete Version angesichts der Commit-Liste korrekt ist. Falls kein vorheriger Tag existiert, verwende
v1.0.0. Überschreibe nur, wenn die berechnete Version offensichtlich falsch ist (z. B. die Injektion gab einen Fehler oder leere Ausgabe zurück).
Schritt 5: Plugin-Manifest synchronisieren (falls vorhanden)
Falls .claude-plugin/plugin.json existiert, aktualisiere dessen version-Feld auf <nächste-version> (ohne v
-Präfix – Plugin-Manifeste verwenden reines Semver wie 1.2.3):
node -e "
const fs = require('fs');
const f = '.claude-plugin/plugin.json';
const d = JSON.parse(fs.readFileSync(f, 'utf8'));
d.version = '<nächste-version>';
fs.writeFileSync(f, JSON.stringify(d, null, 2) + '\n');
"
Dann committen und pushen:
git add .claude-plugin/plugin.json
git commit -m "chore: sync plugin.json version to v<nächste-version>"
git push
Diesen Schritt komplett überspringen, falls .claude-plugin/plugin.json nicht existiert.
Schritt 6: Taggen und releasen
git tag -a v<nächste-version> -m "Release v<nächste-version>"
git push origin v<nächste-version>
gh release create v<nächste-version> \
--generate-notes \
--title "v<nächste-version>"
Schritt 7: Geschlossene Issues schließen (nur main-Branch)
Diesen Schritt überspringen, falls in Schritt 3 ein PR erstellt wurde – GitHub schließt die Issues automatisch, wenn
der PR über die Closes #N-Schlüsselwörter im PR-Body gemerged wird.
Falls die Promotion direkt auf main stattfand (kein PR), die identifizierten Issues jetzt schließen:
gh issue close <N> --comment "Gelöst in $(gh release view v<nächste-version> --json url --jq '.url')"
Schritt 8: Gemergten Feature-Branch bereinigen
Falls ein Feature-Branch in Schritt 3 gemerged wurde, lösche ihn lokal und remote:
git branch -d <feature-branch>
git push origin --delete <feature-branch>
Schritt 9: Sauberen Zustand bestätigen
git status
git log --oneline -5
Die GitHub-Release-URL von gh release view v<nächste-version> --json url --jq '.url' melden.