Menü
Generate deployment summary
Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.
Basierend auf der SOC-Berufsklassifikation
Create formatted branches
Create conventional commits
Contextual linting
Create pull requests
Pre-commit security validation
| description | Generate deployment summary |
| name | changelog |
| version | 1.0.0 |
Génère un résumé des changements entre staging (pré-prod) et main (prod) pour communication.
/changelog # Affiche le résumé staging → main
/changelog --save # Sauvegarde dans release-notes.md
/changelog --from <commit> # Affiche le résumé depuis un commit → dernier de staging
/changelog --from <commit> --save
/changelog --slack # Affiche un rendu optimisé pour Slack
/changelog --slack --compact # Version Slack compacte
Ce skill génère un résumé de déploiement accessible, regroupé par application, pour communiquer les changements aux utilisateurs non techniques.
Important : Ce skill ne modifie PAS le fichier CHANGELOG.md à la racine, qui est géré automatiquement par le workflow GitHub Actions .github/workflows/changelog.yml.
# Définir la plage de commits
RANGE="main..staging"
# En mode --from, utiliser :
# RANGE="<commit>..staging"
# Lister les commits sur la plage
git log "$RANGE" --oneline --no-merges
# Compter les commits
COMMIT_COUNT=$(git log "$RANGE" --oneline --no-merges | wc -l | xargs)
Si aucun commit :
✅ Aucune différence entre staging et main
→ staging et main sont synchronisés
→ Pas de déploiement en attente
STOP
--from)# Vérifier que le commit existe
git cat-file -e <commit>^{commit}
# Vérifier que le commit est bien ancêtre de staging
git merge-base --is-ancestor <commit> staging
Si le commit est invalide ou hors de l'historique de staging :
❌ Commit invalide ou absent de l'historique de staging
→ Vérifier l'identifiant fourni
→ Utiliser un commit présent sur la branche staging
STOP
# Extraire commits par domaine
git log "$RANGE" --pretty=format:"%s" --no-merges
Grouper par scope :
feat(api): / fix(api): → APIfeat(app): / fix(app): → App (Back-office)feat(widget): / fix(widget): → Widgetfeat(analytics): / fix(analytics): → Analyticsfeat(jobs): / fix(jobs): → Jobschore(ci): → InfrastructureIgnorer :
chore(deps): (dépendances)test: (tests)refactor: (refactoring interne)Mapping type → langage utilisateur :
| Type | Langage technique | Langage accessible |
|---|---|---|
feat | Feature | ✨ Nouveauté |
fix | Bug fix | 🐛 Correction |
chore | Maintenance | 🔧 Amélioration technique |
Exemples de traduction :
Commit technique :
feat(api): add client tracking to stat events
→ Traduction accessible :
✨ API : Ajout du suivi par client pour les événements statistiques
Commit technique :
fix(widget): correct date picker validation
→ Traduction accessible :
🐛 Widget : Correction de la validation du sélecteur de dates
Commit technique :
feat(app): add organization filter to missions page
→ Traduction accessible :
✨ Back-office : Nouveau filtre par organisation sur la page missions
Format markdown :
# 🚀 Résumé de Déploiement
**Période** : [Date dernière release main] → Aujourd'hui
**Environnement** : staging → production
**Commits** : 15 changements
---
## 📱 Widget (Widgets Publics)
### ✨ Nouveautés
- Nouveau filtre par organisation sur le widget bénévolat
- Ajout de la pagination pour afficher plus de missions
### 🐛 Corrections
- Correction de la validation du sélecteur de dates
- Amélioration de l'affichage mobile sur petits écrans
---
## 🖥️ Back-office (Interface Admin)
### ✨ Nouveautés
- Ajout d'un tableau de bord pour les statistiques par client
- Export CSV des missions avec filtres avancés
### 🐛 Corrections
- Correction du tri par date de création
---
## 🔌 API
### ✨ Nouveautés
- Ajout du suivi par client pour les événements statistiques
- Nouveau endpoint `/api/v2/stats/by-client`
### 🐛 Corrections
- Correction de la validation des paramètres de date
---
## 📊 Analytics
### ✨ Nouveautés
- Nouveaux modèles dbt pour le tracking des missions actives
- Ajout d'indicateurs de performance par organisation
---
## 🔧 Infrastructure
- Mise à jour des dépendances de sécurité
- Amélioration des performances des tests d'intégration
---
**Note** : Ce résumé est généré automatiquement à partir des commits entre `main` et `staging` (ou entre `<commit>` et `staging` en mode `--from`).
Format Slack (texte) :
🚀 Résumé de déploiement (staging → prod)
Période : 12/02 → 18/02 · 15 changements
📱 Widget
✨ Nouveautés
- Nouveau filtre par organisation
🐛 Corrections
- Correction de la validation des dates
🖥️ Back-office
✨ Nouveautés
- Export CSV avec filtres avancés
Format Slack compact :
🚀 Résumé de déploiement (staging → prod)
Période : 12/02 → 18/02 · 15 changements
📱 Widget : ✨ 2 · 🐛 1
🖥️ Back-office : ✨ 1
🔌 API : ✨ 3 · 🐛 2
📊 Analytics : ✨ 2
🔧 Infrastructure : 🔧 1
Mode console :
→ Génération du résumé de déploiement...
✅ Résumé généré (15 commits)
[Affichage du markdown ci-dessus]
→ Applications impactées :
- Widget : 4 changements (2 nouveautés, 2 corrections)
- Back-office : 3 changements (2 nouveautés, 1 correction)
- API : 5 changements (3 nouveautés, 2 corrections)
- Analytics : 2 changements (2 nouveautés)
- Infrastructure : 1 changement
→ Actions :
1. Copier ce résumé pour communication (Slack, email, etc.)
2. Sauvegarder : /changelog --save
3. Déployer après validation : git checkout main && git merge staging
Mode Slack :
→ Génération du résumé (format Slack)...
✅ Résumé Slack généré (15 commits)
[Affichage du texte Slack ci-dessus]
→ Copier/coller directement dans Slack
--save)Si flag --save activé :
# Sauvegarder dans un fichier temporaire
cat > release-notes.md << 'EOF'
[Contenu du résumé]
EOF
Afficher :
✅ Résumé sauvegardé : release-notes.md
→ Fichier : release-notes.md
→ Usage :
- Partager sur Slack/email
- Ajouter aux notes de release GitHub
- Archiver dans documentation
→ Le fichier release-notes.md n'est PAS versionné (ajouté au .gitignore)
/changelog
Sortie :
→ Comparaison main...staging
→ Commits trouvés : 15
- Widget : 4
- Back-office : 3
- API : 5
- Analytics : 2
- Infrastructure : 1
[Affichage du résumé markdown]
→ Copier le résumé ci-dessus pour communication
/changelog --save
Sortie :
→ Génération du résumé...
✅ Résumé sauvegardé : release-notes.md
→ Contenu : 15 commits, 5 applications
→ Fichier : release-notes.md (non versionné)
/changelog --from a1b2c3d
Sortie :
→ Comparaison a1b2c3d...staging
→ Commits trouvés : 6
- Widget : 2
- Back-office : 1
- API : 2
- Infrastructure : 1
[Affichage du résumé markdown]
→ Copier le résumé ci-dessus pour communication
/changelog --slack
Sortie :
→ Génération du résumé (format Slack)...
✅ Résumé Slack généré (15 commits)
[Affichage du texte Slack]
/changelog
Sortie :
✅ Aucune différence entre staging et main
→ staging et main sont synchronisés
→ Pas de déploiement en attente
Ton :
Style :
❌ À éviter :
- "Implémentation du tracking client via événements stat"
- "Refactorisation du repository Prisma"
- "Fix du bug de validation Zod"
✅ Bon :
- "Ajout du suivi par client dans les statistiques"
- "Amélioration technique de la base de données"
- "Correction de la validation des formulaires"
Niveaux de détail :
Technique : feat(widget): add client filter to dashboard
Accessible : Nouveau filtre par client sur le tableau de bord
Technique : fix(widget): correct responsive layout on mobile
Accessible : Correction de l'affichage mobile pour une meilleure lisibilité
Technique : feat(app): add CSV export with advanced filters
Accessible : Export CSV des données avec filtres personnalisables
Technique : fix(app): fix date sorting in missions table
Accessible : Correction du tri par date dans la liste des missions
Technique : feat(api): add /v2/stats/by-client endpoint
Accessible : Nouveau point d'accès API pour les statistiques par client
Technique : fix(api): validate date parameters in queries
Accessible : Amélioration de la validation des dates dans les requêtes
Technique : feat(analytics): add active missions dbt model
Accessible : Nouveaux indicateurs pour suivre les missions en cours
Technique : feat(analytics): create organization performance metrics
Accessible : Calcul automatique des performances par organisation
Important : Le fichier CHANGELOG.md à la racine est géré par .github/workflows/changelog.yml :
Ce skill est complémentaire :
Permissions requises dans .claude/settings.local.json :
Bash(git log:*)Bash(git diff:*)Read(*)Write(release-notes.md) (optionnel)Ce skill fait partie du workflow de release :
/changelog : Générer résumé de déploiement