Parcours Agents IA · Atelier sur un dépôt fictif · Documentation consultée le 20 novembre 2026.
Codex peut lire un projet, modifier des fichiers et exécuter des commandes autorisées. Pour apprendre à bien le guider, prends un petit bug dont tu connais déjà le résultat attendu. Tu pourras ainsi juger le changement et les tests, puis décider quoi garder.
- Projet et briefChoisis le dépôt et définis le résultat attendu.
- InspectionCodex lit les règles du dépôt et repère les fichiers pertinents.
- Correctif et testsTravaille dans le périmètre choisi et exécute les tests ciblés.
- RelectureCompare le diff aux critères avant commit ou publication.
Choisir la bonne façon d’ouvrir le projet
Dans l’application de bureau ChatGPT, sélectionne Codex et ouvre le dossier de ton dépôt. Le démarrage officiel distingue cette interface du terminal et de l’extension d’éditeur. Le CLI Codex convient quand tu travailles déjà dans un terminal. Dans ce cas, lance-le depuis le dépôt pour que le contexte de départ soit le bon.
Utilise un dépôt d’exercice avec un premier commit. Sur ton dépôt habituel, commence par vérifier l’état Git. Si tu veux isoler l’exercice de tes modifications en cours, sélectionne Worktree dans le nouveau chat et choisis une branche de départ. Le worktree est une autre copie de travail du même dépôt Git. Vérifie dans quelle copie tu lances les tests et où tu veux récupérer le changement. Guide des worktrees.
Donner à l’agent une tâche avec une sortie vérifiable
Enregistre le fichier suivant sous minutes.py dans le dépôt d’exercice. Il ne complète pas les heures sur deux chiffres et il accepte les durées négatives.
def format_minutes(total: int) -> str:
heures, minutes = divmod(total, 60)
return f"{heures}:{minutes:02d}"
Commence par une demande de diagnostic. Ajoute la contrainte qui compte pour toi et un critère de vérification. Quand le périmètre te convient, confie la modification.
Lis minutes.py et propose un correctif. Pour l’instant, décris ton plan.
Le résultat attendu est HH:MM, avec deux chiffres au minimum de chaque côté.
0 donne 00:00, 5 donne 00:05, 60 donne 01:00, 125 donne 02:05.
Une durée négative doit lever ValueError. Conserve la signature de la fonction.
Lors de la réalisation, limite-toi à minutes.py et test_minutes.py.
Utilise unittest et indique les commandes et leurs résultats. Garde le changement local.
Cette formulation donne des points que tu peux vérifier. Pour une règle valant pour toute l’équipe, comme la commande de test ou le répertoire à préserver, utilise un AGENTS.md au bon niveau du dépôt. Une demande ponctuelle reste plus facile à retrouver dans son propre chat. Instructions de projet dans AGENTS.md.
Suivre les permissions pendant l’exécution
Le modèle propose des opérations, et les paramètres de permissions déterminent celles qui peuvent s’exécuter. Pour cet exercice, les modifications nécessaires portent sur le dossier d’essai. Si une approbation apparaît, relis la commande, le dossier visé et l’effet attendu. Demande une solution plus étroite quand l’opération dépasse ton objectif. Les modes et approbations disponibles varient selon l’interface et les règles de l’organisation. Permissions et approbations.
Relire le diff et refaire les tests
Ouvre le diff dans l’interface ou utilise le terminal du même projet. Vérifie les cas limites et cherche les fichiers modifiés par surprise. Lis aussi le nouveau fichier de tests s’il apparaît comme non suivi dans Git, car un diff classique peut omettre les fichiers non ajoutés.
git status --short
git diff --check
git diff -- minutes.py
python -m unittest discover
Le rapport final doit indiquer les fichiers touchés, les tests réellement lancés et les décisions restantes. Sépare une commande qui a produit un résultat d’une commande seulement suggérée. Tu peux consulter le guide de revue lorsque tu veux relire un changement plus grand. Un contrôle propre de Git aide à lire le diff, tandis que des tests pertinents vérifient le comportement.
Passer à un vrai ticket
Garde les mêmes repères. Choisis une modification courte, décris l’état attendu, indique les dossiers concernés et prévois ce qui permettra de dire que c’est terminé. Si un travail doit s’exécuter sur un serveur, sélectionne un environnement distant documenté et vérifie où sont installées ses dépendances. Cette distinction compte surtout quand tu fermes le poste ou que la tâche dépend d’un service interne.