Flux de travail
- Inspectez l'état du dépôt :
git status --short, git diff --cached et git diff. Vérifiez aussi git log --oneline -10 pour correspondre au style existant.
- Si rien n'est stagifié, stagifiez les changements pertinents par chemin explicite (évitez
git add -A si des fichiers non liés ou sensibles sont présents). Ne stagifiez jamais .env, les secrets, ou .venv.
- Si les changements contiennent des préoccupations clairement non liées, divisez-les en commits séparés.
- Écrivez le message en respectant le format ci-dessous, puis committez avec
git commit.
- Exécutez
git status pour vérifier que le commit a réussi.
- Ne poussez que si l'utilisateur a passé
--push : exécutez git push (utilisez git push -u origin <branche> si aucune amont n'est configurée). Ne forcez jamais le push.
Format du message
<type>(<portée optionnelle>): <description>
<corps optionnel>
<pied de page optionnel>
- Types :
feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert.
- Description : mode impératif, minuscule, pas de point final, ~72 caractères max.
- Portée : nom court pour la zone affectée (ex.
cli, serveur, traduire) ; omettez si peu clair.
- Corps : expliquez le pourquoi, enveloppé à ~72 caractères ; omettez pour les modifications triviales.
- Changements cassants : ajoutez
! après le type/portée et un pied de page BREAKING CHANGE:.
Règles
- Ne modifiez pas, ne rebasifiez pas et ne réécrivez pas l'historique sauf demande explicite.
- Ne sautez pas les hooks (
--no-verify).
- Si un hook échoue, corrigez le problème et créez un nouveau commit.
- Ne committez pas en l'absence de changements ; dites-le plutôt.