Générateur de Message de Commit
Ce fichier est la source unique de vérité, chaque agent (Claude / opencode / codex) y fait référence via son propre adaptateur léger (shim).
Processus
- Exécutez
git diff --stagedpour voir les modifications stagées ; si vide, indiquez « Faites d'abordgit add» et arrêtez-vous. - Générez un message selon les règles ci-dessous, affichez-le à l'utilisateur pour confirmation, ne validez pas directement ; si l'utilisateur doit choisir, donnez directement les messages optionnels, ne vous contentez pas de demander.
- N'exécutez
git commit -mque lorsque l'utilisateur confirme (ex. répond « Valider » ou « OK »). Ne faites pasgit pushsauf demande explicite.
Règles
Lisez git diff --staged et générez un message en suivant les Conventional Commits, en expliquant le QUOI et le POURQUOI.
- Titre
type(scope): description, longueur totale ≤ 74 caractères, pas de point à la fin, aucun préfixe/guillemet/bloc de code. - type choisissez le plus pertinent :
featnouvelle fonctionnalité ·fixcorrection de bugrefactorrefactorisation sans changement de comportement externe (ni nouvelle fonctionnalité ni correction de bug) ·perfoptimisation des performancesdocsuniquement documentation ·styleajustements de format sans impact sémantique (espaces blancs/format/points-virgules, etc.)testajout ou correction de tests ·buildmodifications du système de construction ou des dépendances externes ·ciconfiguration et scripts CIchoreautres tâches n'affectant pas src/test ·revertannulation d'un commit précédent
- scope (optionnel) nom du module affecté, selon les conventions de ce dépôt – pour un monorepo, utilisez le nom du répertoire app/package ; si plusieurs modules sont concernés ou si vous hésitez, omettez-le.
- La description doit être en français : une phrase verbe-objet concise expliquant « ce qui a été fait », sans expressions creuses comme « Plusieurs fichiers ont été modifiés », « Ce commit » ou « Cette modification » ; les identifiants (noms de fonctions/fichiers/packages) restent en anglais.
- Un seul ligne : en toutes circonstances, le message de commit n'a qu'une seule ligne de titre, pas de corps/pied de page ; intégrez le POURQUOI nécessaire dans cette ligne.
- Breaking change marquez avec un
!danstype(scope)!: description, restez sur une seule ligne, n'utilisez pas le pied de pageBREAKING CHANGE. - Ponctuation utilisez la ponctuation anglaise semi-large, pas les pleines largeurs
,。:().
Stratégie de Génération
Avant d'écrire, réfléchissez d'abord au « problème résolu par cet ensemble de modifications / à la ligne directrice », puis suivez le format ci-dessus :
- Identifiez la ligne directrice : n'écrivez que les informations nécessaires à la compréhension de ce commit, ne listez pas les noms de fichiers/fonctions/configurations (sauf s'ils sont eux-mêmes cruciaux).
- Repérez les changements significatifs : y a-t-il des modifications de logique, de contrat, de construction, de porte qualité ou de comportement utilisateur visible ? Choisissez le type approprié en conséquence, et déterminez si le
!pour breaking est nécessaire.
Discipline de Contenu (D'où vient le QUOI)
Ce qui précède concerne le format ; ce qui suit concerne la véracité du contenu – le message ne doit relater que des faits de code confirmés, sans deviner les intentions ni extrapoler à partir de la documentation :
- Priorisez les modifications de comportement dans
src/test: la documentation ne sert que de contexte secondaire, ne l'utilisez pas pour déduire le QUOI (la documentation est souvent en avance ou en retard sur le code). - Le contexte de la conversation prime sur la documentation : les objectifs explicitement mentionnés dans les prompts récents de l'utilisateur peuvent être utilisés pour le POURQUOI ou pour choisir un libellé plus pertinent (ex. « Correction de la vérification/typecheck complète ») ; mais le QUOI/scope repose toujours sur le diff stagé – les informations contextuelles non reflétées dans le diff ne doivent pas être incluses dans le message. En cas de conflit, le diff prime et demandez confirmation.
- Diff de suppression/renommage : si vous ne pouvez pas confirmer le but via les relations d'appel de code, contentez-vous de déclarations objectives (
Supprimer X/X renommé en Y), n'écrivez pas de relations causales fortes comme « remplace / migre vers / change en ». - Plusieurs points de changement mais un même objectif (ex. une correction de qualité de code/construction) → donnez directement un message récapitulatif unique ; ne proposez une séparation que si elle améliore significativement la revue/le rollback, et alors en option complémentaire, sans bloquer par défaut.
- Mélange évident d'objectifs indépendants (fonctionnalités/corrections) → fournissez tout en une fois : les messages unitaires pour chaque partie + un message récapitulatif prudent, laissant l'utilisateur choisir entre décomposition ou synthèse, sans reporter la synthèse au tour suivant ; ne forcez un résumé que si le QUOI global ne peut être objectivement synthétisé, sinon listez simplement les unités.
- Modifications dont l'appartenance/l'intention n'est pas claire (parallèles, sans raison apparente) → produisez « Ces fichiers nécessitent une confirmation d'appartenance/intention », plutôt que de forcer un message ; en cas d'incertitude, évitez les mots vagues comme « rangement / ajustement », préférez demander à l'utilisateur de confirmer ou décomposer.