name: gen-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

Gen Release Notes Skill

Instructions à Exécuter

IMPORTANT : Exécute ce workflow étape par étape :

Usage

/git:gen-release-notes <branche-source> <branche-cible> [nom-release]

Si arguments manquants : AskUserQuestion pour demander.

Workflow

Initialisation

Créer les tâches du workflow :

Utiliser TaskCreate pour chaque étape :

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

Pattern d'exécution pour chaque étape :

TaskUpdate → tâche en in_progress
Exécuter l'étape
TaskUpdate → tâche en 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	⭐	feat, ✨, 🚀
Améliorations	📈	improve, ⚡, perf
Corrections	✅	fix, 🐛
Sécurité	🔒	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

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

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
Les tâches permettent à l'utilisateur de suivre la génération des release notes

References

Template HTML - Structure et CSS du fichier généré
Règles de rédaction - Exemples de transformation et conventions

Name	gen-release-notes
Description	Génère des notes de release HTML orientées utilisateurs finaux. Transforme les commits techniques en descriptions accessibles sans jargon.

gen-release-notes

SKILL.md