| name | devops:release-notes |
| description | Génère des notes de release HTML orientées utilisateurs finaux. Transforme les commits techniques en descriptions accessibles sans jargon.
|
| allowed-tools | ["Bash","Read","Write","Grep","Glob","AskUserQuestion"] |
| model | sonnet |
| version | 1.0.0 |
| license | MIT |
DevOps Release Notes Skill
Instructions à Exécuter
IMPORTANT : Exécute ce workflow étape par étape :
Usage
/devops:release-notes <branche-source> <branche-cible> [nom-release]
Si arguments manquants : AskUserQuestion pour demander.
Workflow
Initialisation
Créer les tâches du workflow :
TaskCreate #1: Parser et valider arguments (branches source/cible)
TaskCreate #2: Collecter commits via git log
TaskCreate #3: Catégoriser par impact utilisateur
TaskCreate #4: Rédiger descriptions sans jargon
TaskCreate #5: Générer HTML dans .claude/reports/
Important :
- Utiliser
activeForm (ex: "Validant les arguments", "Collectant les commits")
- Chaque tâche doit être marquée
in_progress puis completed
Étapes
- Parser et valider arguments (branches source/cible)
- Collecter commits via
git log
- Catégoriser par impact utilisateur
- Rédiger descriptions sans jargon
- Générer HTML dans
.claude/reports/
Catégories
| Catégorie | Icône | Mots-clés |
|---|
| Nouveautés | Etoile | feat, improve |
| Améliorations | Graphe | improve, perf |
| Corrections | Check | fix |
| Sécurité | Cadenas | security |
Commits ignorés
refactor:, test:, chore:, ci:, docs:, style:
- Commits de merge
- Mises à jour de dépendances
Règles de rédaction
- ZÉRO jargon - Pas de API, SQL, cache, endpoint, refactoring
- Bénéfice utilisateur - "L'application est plus rapide" vs "Optimisation SQL"
- Verbes d'action - "Vous pouvez maintenant...", "Nous avons corrigé..."
- Phrases courtes - Max 1-2 phrases par item
Exemples de transformation
| Commit | Note utilisateur |
|---|
feat: implémenter cache Redis | L'affichage est plus rapide |
fix: corriger validation email | Certaines adresses email sont maintenant acceptées |
Output
{REPORT_PATH}/release_notes_{RELEASE_NAME}.html
où REPORT_PATH = .claude/reports
Task Management
Progression du workflow :
- 5 tâches créées à l'initialisation
- Chaque étape suit le pattern :
in_progress -> exécution -> completed
- Utiliser
TaskList pour voir la progression
References
Pour le template HTML et les règles de rédaction détaillées, consulter :
devops/skills/release-notes/references/html-template.html
devops/skills/release-notes/references/writing-rules.md