Écrire les notes de version
- Trouver la plage :
git describe --tags --abbrev=0donne le dernier tag. S'il n'y en a pas, utiliser tout l'historique. - Lister les sujets :
git log <dernier-tag>..HEAD --no-merges --pretty=format:%s. - Appeler l'outil MCP
group_commits(serveurteam-kit) avec ces sujets. Il renvoie du Markdown groupé par type, avec les modifications cassantes en premier. Si l'outil n'est pas disponible, les regrouper manuellement en utilisant les mêmes en-têtes. - Réécrire pour les lecteurs, pas pour les commiteurs : une phrase simple par élément, effet visible pour l'utilisateur en premier, pas de bruit de ticket. Fusionner les doublons. Conserver tout ce qui se trouve sous « Breaking changes » et indiquer ce que les utilisateurs doivent faire.
- Générer :
## <version> (<YYYY-MM-DD>)
<paragraphe de résumé de 2-3 phrases>
<sections groupées>
N'inventez jamais de modifications qui ne figurent pas dans la liste des commits. Si un commit n'est pas clair, lisez son diff (git show <sha> --stat) avant de le décrire. Demandez à l'utilisateur le numéro de version si vous ne pouvez pas le déduire.