Que fait Promouvoir les Modifications ?
Exécute le workflow complet de release depuis l'état de travail courant jusqu'à une release GitHub taguée sur main.
Branche actuelle : !git branch --show-current 2>/dev/null || echo "inconnue"
État Git : !git status --short 2>/dev/null || echo "pas un dépôt git"
Dernier tag : !git describe --tags --abbrev=0 2>/dev/null || echo "aucun"
Commits récents depuis le dernier tag :
!`git log $(git describe --tags --abbrev=0 2>/dev/null || echo "")..HEAD --oneline -10 2>/dev/null || git log --oneline -10`
Prochaine version (calculée à partir des commits ci-dessus) :
!`(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)`
Étape 0 : Vérifications préliminaires
gh auth status 2>&1 || { echo "ERREUR : gh n'est pas authentifié. Exécutez : gh auth login"; exit 1; }
Vérifiez la présence de fichiers .env non suivis qui pourraient être accidentellement indexés :
git status --short | grep -E '^\?\? .*\.env' && echo "ATTENTION : des fichiers .env non suivis ont été détectés — vérifiez avant d'indexer"
cat .gitignore 2>/dev/null | grep -q '\.env' || echo "ATTENTION : .gitignore n'exclut pas les fichiers .env"
Si des fichiers .env doivent être indexés :
if [ -t 0 ]; then
# Mode interactif — demande une confirmation avant de continuer
read -p "ATTENTION : fichiers .env détectés. Continuer ? (o/N) " confirm
[[ "$confirm" =~ ^[Oo]$ ]] || { echo "Annulé."; exit 1; }
else
# Mode non interactif — arrêt immédiat ; trop risqué de continuer sans validation humaine
echo "ERREUR : fichiers .env non suivis détectés en mode non interactif. Abandon."
exit 1
fi
Étape 1 : Commiter les modifications non validées
Si l'état Git ci-dessus montre des modifications non validées ou non suivies :
- Examinez le diff :
git diffetgit diff --cached - Indexez les modifications de manière sélective — privilégiez les fichiers suivis :
git add -u, puis vérifiez et ajoutez les éventuels nouveaux fichiers intentionnels individuellement. Évitezgit add -Asauf confirmation explicite de l'utilisateur. - Rédigez un message de commit conventionnel à partir des modifications — commencez par un préfixe de type (
feat:,fix:,docs:,chore:, etc.) et un résumé concis - Commitez en utilisant un heredoc pour que les messages multilignes soient correctement formatés
S'il n'y a rien à commiter, passez à l'Étape 2.
Étape 2 : Push
Poussez la branche courante vers le dépôt distant :
git push -u origin HEAD
Étape 3 : Fusionner vers main (branche de fonctionnalité uniquement)
Ignorez cette étape si vous êtes déjà sur main (ou la branche par défaut du dépôt).
Si vous êtes sur une branche de fonctionnalité :
-
Analysez les commits depuis le dernier tag pour trouver des références à des issues :
git log $(git describe --tags --abbrev=0 2>/dev/null || echo "")..HEAD --format="%B"Recherchez
Closes #N,Fixes #N,Resolves #N(insensible à la casse). Collectez tous les numéros d'issues trouvés. Si aucun n'est trouvé :if [ -t 0 ]; then # Mode interactif — demande à l'utilisateur read -p "Des issues GitHub sont-elles résolues ? (ex. 12 15 — ou Entrée pour ignorer) " issues else # Mode non interactif — ignore silencieusement issues="" fi -
Créez une PR ciblant main, incluant des mots-clés de fermeture dans le corps pour que GitHub ferme automatiquement les issues lors de la fusion :
gh pr create --title "<type>: <résumé>" --body "$(cat <<'EOF' ## Résumé <points clés des commits> Closes #N, Closes #N 🤖 Généré avec [claude-workflow-skills:promote](https://github.com/ali5ter/claude-workflow-skills) au nom de [Alister](https://github.com/ali5ter) EOF )"Omettez les lignes
Closessi aucune issue n'a été identifiée. -
Activez la fusion automatique (squash de préférence) :
gh pr merge --auto --squash -
Interrogez jusqu'à la fusion :
gh pr view --json state --jq '.state' -
Passez sur main et tirez :
git checkout main && git pull
Étape 4 : Confirmer la prochaine version
La prochaine version est pré-calculée dans le bloc de contexte ci-dessus en utilisant ces règles semver :
- Sujet de commit avec
!:(ex.feat!:,fix!:) → incrémentation majeure - Sujet de commit commençant par
feat→ incrémentation mineure - Tous les autres commits → incrémentation corrective
Confirmez que la version calculée est correcte compte tenu de la liste des commits. Si aucun tag précédent n'existe, utilisez v1.0.0. N'outrepassez que si la version calculée est clairement erronée (par exemple, l'injection a renvoyé une erreur ou une sortie vide).
Étape 5 : Synchroniser le manifeste du plugin (si présent)
Si .claude-plugin/plugin.json existe, mettez à jour son champ version avec <prochaine-version> (sans préfixe v — les manifestes de plugin utilisent la semver nue comme 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 = '<prochaine-version>';
fs.writeFileSync(f, JSON.stringify(d, null, 2) + '\n');
"
Puis commitez et poussez :
git add .claude-plugin/plugin.json
git commit -m "chore: synchroniser la version du plugin.json en v<prochaine-version>"
git push
Ignorez complètement cette étape si .claude-plugin/plugin.json n'existe pas.
Étape 6 : Tagger et publier la release
git tag -a v<prochaine-version> -m "Release v<prochaine-version>"
git push origin v<prochaine-version>
gh release create v<prochaine-version> \
--generate-notes \
--title "v<prochaine-version>"
Étape 7 : Fermer les issues résolues (branche main uniquement)
Ignorez cette étape si une PR a été créée à l'Étape 3 — GitHub fermera automatiquement les issues lors de la fusion de la PR via les mots-clés Closes #N dans le corps de la PR.
Si la promotion a été effectuée directement sur main (sans PR), fermez les issues identifiées maintenant :
gh issue close <N> --comment "Résolu dans $(gh release view v<prochaine-version> --json url --jq '.url')"
Étape 8 : Nettoyer la branche de fonctionnalité fusionnée
Si une branche de fonctionnalité a été fusionnée à l'Étape 3, supprimez-la localement et à distance :
git branch -d <branche-de-fonctionnalité>
git push origin --delete <branche-de-fonctionnalité>
Étape 9 : Confirmer un état propre
git status
git log --oneline -5
Signalez l'URL de la release GitHub depuis gh release view v<prochaine-version> --json url --jq '.url'.