Wiki Changelog
Génère des changelogs structurés à partir de l'historique git.
Résolution du dépôt source (OBLIGATOIRE EN PREMIER)
Avant de générer un changelog, tu DOIS déterminer le contexte du dépôt source :
- Vérifier le remote git : Exécute
git remote get-url originpour déterminer si un remote existe - Demander à l'utilisateur : « Est-ce un dépôt local uniquement, ou avez-vous une URL de dépôt source (par exemple GitHub, Azure DevOps) ? »
- URL du remote fournie → stocker comme
REPO_URL, utiliser des citations liées pour les hashes de commits et les références de fichiers - Local uniquement → utiliser les hashes de commits et références de fichiers en texte brut
- URL du remote fournie → stocker comme
- NE PAS continuer tant que le contexte du dépôt source n'est pas résolu
Quand l'activer
- L'utilisateur demande « qu'est-ce qui a changé récemment », « génère un changelog », « résume les commits »
- L'utilisateur souhaite comprendre l'activité de développement récente
Procédure
- Examiner le git log (commits, dates, auteurs, messages)
- Grouper par période : quotidien (7 derniers jours), hebdomadaire (plus ancien)
- Classer chaque commit : Fonctionnalités (🆕), Corrections (🐛), Refactoring (🔄), Docs (📝), Config (🔧), Dépendances (📦), Breaking (⚠️)
- Générer des descriptions concises destinées aux utilisateurs en utilisant la terminologie du projet
Contraintes
- Se concentrer sur les changements visibles pour l'utilisateur
- Fusionner les commits connexes en descriptions cohérentes
- Utiliser la terminologie du projet à partir du README
- Mettre en avant les changements cassants de manière évidente avec les notes de migration
- Quand
REPO_URLest disponible, lier les hashes de commits :[abc1234](REPO_URL/commit/abc1234)et les fichiers modifiés :[file_path](REPO_URL/blob/BRANCH/file_path)