Quand un agent annonce « terminé », vérifie ce qui a changé et ce qui a réellement été testé. Cette méthode fonctionne avec Codex, Claude Code ou un autre assistant. Nous utiliserons un dépôt Python fictif, GitHub pour la revue et, facultativement, CodeRabbit pour obtenir un avis automatisé supplémentaire. La décision reste humaine.
- Branche et pull requestRetrouve la tâche et les commits à relire.
- Diff et testsCompare à la base de la PR et vérifie les fichiers et les contrôles.
- Seconde lecture facultativeUne revue CodeRabbit peut signaler des points à examiner.
- Revue humaineValide les écarts et les résultats des tests avant de fusionner.
1. Fixer un résultat vérifiable
Prépare une copie sur un serveur de revue isolé sans secrets de production, Git, l’environnement de test du projet et un accès de lecture à sa PR. Notre contrat fictif impose que normalize_name(" Ada ") renvoie "Ada" et qu’une chaîne vide déclenche ValueError. Aucun changement de dépendance n’est demandé.
Les guides officiels de Codex et de Claude Code recommandent de fournir un objectif et des critères de vérification. Demande le périmètre modifié, les commandes exécutées et leurs limites. Ces indications te donnent un point de départ pour la revue.
2. Examiner tout le travail local
Dans la copie de travail de l’agent, repère les changements avec les commandes suivantes.
git status --short --untracked-files=all
git rev-parse HEAD
git diff --stat
git diff
git diff --cached
git ls-files --others --exclude-standard
La documentation Git diff distingue les modifications non indexées et celles préparées pour le prochain commit. Les nouveaux fichiers non suivis apparaissent dans le statut Git. Ouvre ces fichiers dans l’éditeur pour les relire. Vérifie aussi les fichiers ignorés si un test dépend d’une configuration locale.
3. Comparer la PR depuis sa bonne base
Pour l’audit d’une PR déjà publiée, utilise une copie de revue propre, placée sur son commit de tête exact. Compare le SHA renvoyé par git rev-parse HEAD au SHA affiché dans GitHub. Remplace origin et main par le distant et la branche cible de la PR si leurs noms diffèrent.
git fetch origin
base_sha=$(git rev-parse --verify origin/main)
printf '%s\n' "$base_sha"
git diff --stat "$base_sha"...HEAD
git diff "$base_sha"...HEAD
Les trois points comparent depuis l’ancêtre commun avec la branche cible. Ils évitent de mélanger simplement tous les changements récents de cette cible avec ceux de la PR. Conserve aussi le SHA de base consulté. Reprends la vérification après chaque nouveau commit de l’agent.
4. Exécuter des tests qui peuvent échouer
Dans cet exemple utilisant déjà pytest, vérifie la collecte, puis lance la suite. Dans Bash, récupère chaque code de sortie avant d’enchaîner.
python -m pytest --collect-only -q
printf 'Collecte %s\n' "$?"
python -m pytest -q
printf 'Tests %s\n' "$?"
git status --short --untracked-files=all
git rev-parse HEAD
La documentation pytest décrit ces modes. Contrôle le nombre de tests, les résultats ignorés et le code de sortie. L’absence de tests collectés correspond normalement au code 5. Enregistre le résultat immédiatement, avec le SHA et l’état de travail. Un arbre modifié pendant l’exécution rend ambigu ce qui a été testé.
Relis les assertions et vérifie qu’elles comparent la valeur obtenue à la valeur attendue. Couvre le cas nominal et le cas d’erreur prévu par le contrat. Pour une interface ou une intégration, prévois aussi un essai du parcours concerné.
Dans le dépôt d’essai, ce fichier tests/test_normalize.py vérifie les deux comportements annoncés. Adapte l’import au nom du module du projet.
import pytest
from normalize import normalize_name
def test_normalize_name_trims_spaces():
assert normalize_name(" Ada ") == "Ada"
def test_normalize_name_rejects_blank_input():
with pytest.raises(ValueError):
normalize_name(" ")
5. Lire le détail des Checks GitHub
Dans GitHub, ouvre Files changed puis Checks et les détails des statuts. Vérifie le commit concerné, les journaux, les commandes et la provenance du contrôle. La documentation des statuts précise qu’un job ignoré peut être considéré comme réussi. Ouvre les journaux pour confirmer que la commande de test a tourné.
Selon l’offre et la visibilité du dépôt, des protections de branche peuvent imposer revue et contrôles requis. Vérifie que la règle couvre la branche cible et regarde quels rôles peuvent la contourner. Garde la fusion automatique désactivée durant la revue.
6. Ajouter CodeRabbit sur un dépôt d’essai
Cette étape est facultative et nécessite une autorisation d’installation. Suis le guide GitHub de CodeRabbit, choisis Only select repositories et uniquement le dépôt d’essai. Examine les droits affichés à l’installation. L’application demande notamment lecture et écriture sur le code, les PR, les checks, les statuts et les workflows.
Avant la première PR, configure les revues automatiques selon ton besoin et laisse les fonctions de correction et d’approbation automatique désactivées. La gestion des revues permet de demander une analyse manuelle. Dans une petite PR ciblée, publie un commentaire contenant uniquement @coderabbitai full review, en texte brut, sans bloc de code. Après une correction, @coderabbitai review demande une revue incrémentale.
Vérifie les limites de ton offre et attends la fin de l’analyse. Classe les remarques selon que tu les confirmes, les écartes ou dois les approfondir. Appuie ta décision sur le diff relu et les tests que tu as vérifiés.
7. Éprouver l’audit avec des fautes simulées
- Fichier oublié : un utilitaire non suivi est indispensable aux tests locaux. Le statut doit révéler qu’il manque à la PR.
- Test trop faible : une assertion accepte
" Ada ". Une assertion d’égalité au résultat attendu doit détecter la régression. - Mauvais commit : les journaux portent sur un SHA précédent. La revue doit rester incomplète jusqu’au contrôle de la nouvelle révision.
Simule ces défauts dans une copie jetable du projet fictif. Note le SHA audité, le périmètre, les tests réellement exécutés, les remarques traitées et les limites restantes. Arrête-toi à la décision de revue.
Sources officielles consultées le 20 novembre 2026. L’intégration GitHub et CodeRabbit est décrite à partir de leurs documentations.