Configuration
Lors de la première utilisation, lisez setup.md. Par défaut : mode des bonnes pratiques (aucune configuration requise).
Quand l'utiliser
L'utilisateur a besoin d'expertise Git — des opérations de base aux workflows complexes. L'agent gère le branchement, le merging, le rebase, la résolution de conflits et les modèles de collaboration d'équipe.
Architecture
Mémoire dans ~/git/. Voir memory-template.md pour la structure.
~/git/
└── memory.md # Préférences utilisateur (optionnel)
Référence rapide
| Sujet | Fichier |
|---|---|
| Commandes essentielles | commands.md |
| Opérations avancées | advanced.md |
| Stratégies de branche | branching.md |
| Résolution de conflits | conflicts.md |
| Historique et récupération | history.md |
| Workflows d'équipe | collaboration.md |
| Configuration | setup.md |
| Mémoire | memory-template.md |
Règles fondamentales
- Ne jamais forcer un push sur les branches partagées — Utilisez
--force-with-leaseuniquement sur les branches de fonctionnalités - Commitez tôt, commitez souvent — Les petits commits sont plus faciles à revoir, annuler et bissecter
- Écrivez des messages de commit significatifs — Première ligne sous 72 caractères, mode impératif
- Tirez avant de pousser — Faites toujours
git pull --rebaseavant de pousser pour éviter les commits de merge - Nettoyez avant de merger — Utilisez
git rebase -ipour squasher les commits de correction
Workflows d'équipe
Flux de branche de fonctionnalité :
git checkout -b feature/nameà partir de main- Faites des commits, poussez régulièrement
- Ouvrez une PR, obtenez une revue
- Squashez et mergez dans main
- Supprimez la branche de fonctionnalité
Flux de correctif :
git checkout -b hotfix/issueà partir de main- Corrigez, testez, commitez
- Mergez dans main ET develop (si elle existe)
- Taguez la version
Synchronisation quotidienne :
git fetch --all --prune
git rebase origin/main # ou merge si l'équipe préfère
Messages de commit
- Utilisez le format de commit conventionnel :
type(scope): description - Gardez la première ligne sous 72 caractères
- Types :
feat,fix,docs,style,refactor,test,chore
Sécurité du push
- Utilisez
git push --force-with-leaseau lieu de--force— évite d'écraser le travail des autres - Si le push est rejeté, exécutez
git pull --rebaseavant de réessayer - Ne forcez jamais le push sur la branche main/master
Résolution de conflits
- Après avoir édité les fichiers en conflit, vérifiez qu'aucun marqueur ne subsiste :
grep -r "<<<\|>>>\|===" . - Testez que le code se compile avant de finaliser le merge
- Si le merge devient complexe, abandonnez avec
git merge --abortet essayezgit rebaseà la place
Hygiène des branches
- Supprimez les branches mergées localement :
git branch -d nom-de-branche - Nettoyez le suivi distant :
git fetch --prune - Avant de créer une PR, rebasez la branche de fonctionnalité sur le dernier main
- Utilisez
git rebase -ipour squasher les commits désordonnés avant de pousser
Liste de sécurité
Avant les opérations destructrices (reset --hard, rebase, force push) :
- Est-ce une branche partagée ? → Ne réécrivez pas l'historique
- Ai-je des modifications non commitées ? → Stashez ou commitez d'abord
- Suis-je sur la bonne branche ? →
git branchpour vérifier - Le dépôt distant est-il à jour ? →
git fetchd'abord
Pièges courants
- git user.email erroné — Vérifiez avec
git config user.emailavant les commits importants - Répertoires vides — Git ne les suit pas, ajoutez
.gitkeep - Sous-modules — Clonez toujours avec
--recurse-submodules - HEAD détachée — Utilisez
git switch -pour revenir à la branche précédente - Push rejeté — Nécessite généralement
git pull --rebased'abord - stash pop sur conflit — Le stash disparaît. Utilisez
stash applyà la place - Fichiers volumineux — Utilisez Git LFS pour les fichiers >50 Mo, ne commitez jamais de secrets
- Sensibilité à la casse — Mac/Windows ignorent la casse, Linux non — provoque des échecs CI
Commandes de récupération
- Annuler le dernier commit en conservant les modifications :
git reset --soft HEAD~1 - Ignorer les modifications non indexées :
git restore fichier - Trouver les commits perdus :
git reflog(conserve environ 90 jours d'historique) - Récupérer une branche supprimée :
git checkout -b nom-de-branche <sha-depuis-reflog> - Utilisez
git add -ppour une indexation partielle lorsque le commit mélange plusieurs modifications
Débogage avec Bisect
Trouvez le commit qui a introduit un bug :
git bisect start
git bisect bad # le commit actuel est cassé
git bisect good v1.0.0 # cette version fonctionnait
# Git extrait le commit du milieu, testez-le, puis :
git bisect good # ou git bisect bad
# Répétez jusqu'à ce que Git trouve le coupable
git bisect reset # revenez à la branche d'origine
Résumé rapide
git status -sb # statut court avec branche
git log --oneline -5 # 5 derniers commits
git shortlog -sn # contributeurs par nombre de commits
git diff --stat HEAD~5 # résumé des modifications des 5 derniers commits
git branch -vv # branches avec infos de suivi
git stash list # stashes en attente
Compétences associées
Installez avec clawhub install <slug> si l'utilisateur confirme :
gitlab— CI/CD GitLab et demandes de fusiondocker— Workflows de conteneurisationcode— Qualité du code et bonnes pratiques
Retour
- Si utile :
clawhub star git - Restez à jour :
clawhub sync