Personnalisation

La personnalisation vous permet d’adapter Codex aux méthodes de travail de votre équipe.

Dans Codex, plusieurs éléments se complètent :

• Consignes de projet (AGENTS.md) pour définir des règles qui s’appliquent d’une session à l’autre
• Mémoires pour conserver le contexte utile acquis lors de travaux précédents
• Skills pour réutiliser des workflows et mobiliser des connaissances spécialisées
• MCP pour accéder à des outils externes et à des systèmes partagés
• Sous-agents pour déléguer des tâches à des sous-agents spécialisés

Chaque élément joue un rôle distinct. AGENTS.md guide le comportement de Codex, les mémoires conservent le contexte local d’une session à l’autre, les skills regroupent les procédures récurrentes et MCP relie Codex à des systèmes externes à l’espace de travail local.

Consignes dans AGENTS.md

AGENTS.md accompagne votre dépôt et fournit à Codex des consignes durables pour le projet. Elles s’appliquent avant même que l’agent commence à travailler. Gardez ce fichier court.

Consignez-y les règles que Codex doit suivre chaque fois qu’il travaille dans le dépôt, par exemple :

• Les commandes de compilation et de test
• Les attentes en matière de revue de code
• Les conventions propres au dépôt
• Les instructions propres à certains répertoires

Lorsque l’agent part d’une hypothèse erronée sur votre code source, apportez la correction dans AGENTS.md. Prenez aussi l’habitude de demander à l’agent de mettre à jour AGENTS.md pour que vos corrections s’appliquent aux sessions suivantes.

Quand mettre à jour AGENTS.md

• Erreurs répétées : si l’agent commet plusieurs fois la même erreur, ajoutez une règle.
• Trop de documents consultés : si l’agent trouve les bons fichiers mais lit trop de documents, indiquez les répertoires ou fichiers à consulter en priorité.
• Remarques récurrentes sur les pull requests : si vous formulez plusieurs fois la même remarque, faites-en une règle.
• Vérifications automatiques des écarts : utilisez des tâches planifiées pour vérifier régulièrement, par exemple chaque jour, si certaines consignes manquent et obtenir des suggestions d’ajouts à AGENTS.md.

Associez AGENTS.md à des outils qui font respecter ces règles. Les hooks de pré-commit, les linters et les vérificateurs de types détectent les problèmes avant même que vous les remarquiez et permettent de mieux prévenir les erreurs récurrentes.

Codex peut charger des consignes depuis plusieurs emplacements : un fichier global dans votre répertoire personnel Codex pour vos propres besoins de développement, et des fichiers que les équipes peuvent versionner dans chaque dépôt. Les fichiers les plus proches du répertoire de travail sont prioritaires. Utilisez le fichier global pour préciser comment Codex doit communiquer avec vous, par exemple le style des revues de code, le niveau de détail et vos préférences par défaut. Réservez les fichiers du dépôt aux règles propres à l’équipe et au code source.

Instructions personnalisées avec AGENTS.md

Skills

Les skills donnent à Codex des capacités qu’il peut réutiliser pour des workflows récurrents. Ils sont souvent le meilleur choix pour ces workflows, car ils peuvent réunir des instructions détaillées, des scripts et des documents de référence utilisables dans plusieurs tâches. Codex charge au minimum les métadonnées des skills. L’agent peut ainsi découvrir et sélectionner les skills sans que vous ayez à les nommer. Il a accès à des workflows détaillés sans encombrer le contexte dès le départ.

Utilisez les dossiers de skills pour créer et affiner vos workflows en local. Si un plugin existe déjà pour le workflow, installez-le d’abord pour profiter d’une configuration éprouvée. Pour partager votre propre workflow avec plusieurs équipes ou le distribuer avec des connecteurs, regroupez le tout dans un plugin. Vous créez le workflow sous forme de skill et le distribuez sous forme de plugin installable.

Un skill comprend généralement un fichier SKILL.md auquel peuvent s’ajouter des scripts, des documents de référence et des ressources.

Le répertoire du skill peut contenir un dossier scripts/ avec des scripts CLI que Codex exécute dans le cadre du workflow, par exemple pour charger des données initiales ou effectuer des vérifications. Si le workflow nécessite des systèmes externes (outils de suivi des tickets, outils de design, serveurs de documentation), associez le skill à MCP.

Exemple de fichier SKILL.md :

---
name: commit
description: Stage and commit changes in semantic groups. Use when the user wants to commit, organize commits, or clean up a branch before pushing.
---

1. N’exécutez pas `git add .`. Indexez ensemble les fichiers dont les modifications répondent au même objectif.
2. Créez des commits distincts en suivant cet ordre : feat → test → docs → refactor → chore.
3. Rédigez des messages de commit concis qui reflètent la portée des modifications.
4. Limitez chaque commit à un seul objectif pour en faciliter la revue.

Utilisez les skills pour :

• Les workflows récurrents (étapes de publication, revues de code régulières, mises à jour de la documentation)
• Le savoir-faire propre à votre équipe
• Les procédures qui nécessitent des exemples, des documents de référence ou des scripts auxiliaires

Les skills peuvent être globaux, dans votre répertoire personnel pour votre propre usage, ou propres à un dépôt, dans le dossier .agents/skills versionné pour votre équipe. Placez les skills dans .agents/skills lorsque le workflow concerne ce projet. Utilisez votre répertoire personnel pour les skills dont vous avez besoin dans tous vos dépôts.

Codex charge les skills progressivement :

• Il commence par les métadonnées (name, description) pour repérer les skills disponibles.
• Il charge SKILL.md uniquement lorsqu’un skill est sélectionné.
• Il consulte les documents de référence ou exécute les scripts uniquement si nécessaire.

Vous pouvez appeler un skill explicitement. Codex peut aussi le sélectionner de lui-même lorsque la tâche correspond à sa description. Une description claire aide Codex à déclencher le skill au bon moment.

Créer des skills

MCP

MCP (Model Context Protocol) est le protocole standard qui permet de connecter Codex à des outils externes et à des fournisseurs de contexte. Il est particulièrement utile pour les systèmes hébergés à distance comme Figma, Linear, GitHub ou les services internes de gestion des connaissances dont dépend votre équipe.

Utilisez MCP lorsque Codex a besoin de fonctionnalités externes au dépôt local, par exemple pour accéder à des outils de suivi des tickets, à des outils de design, à des navigateurs ou à des systèmes de documentation partagés.

La connexion fait intervenir trois éléments :

• Hôte : Codex
• Client : la connexion MCP au sein de Codex
• Serveur : l’outil externe ou le fournisseur de contexte

Les serveurs MCP peuvent exposer :

• Des outils (actions)
• Des ressources (données consultables)
• Des prompts (modèles de prompts réutilisables)

Cette distinction vous aide à déterminer à quels composants vous faites confiance et quelles actions chacun peut effectuer. Certains serveurs fournissent surtout du contexte, tandis que d’autres donnent accès à des actions puissantes.

En pratique, MCP est souvent particulièrement utile en association avec des skills :

• Le skill définit le workflow et précise les outils MCP à utiliser.

Model Context Protocol

Sous-agents

Vous pouvez créer plusieurs agents, leur attribuer des rôles distincts et leur donner des consignes différentes sur l’utilisation des outils. Par exemple, un agent peut lancer des tests avec des commandes et des configurations précises, tandis qu’un autre utilise des serveurs MCP pour récupérer les journaux de production à des fins de débogage. Chaque sous-agent se concentre sur sa tâche et utilise les outils adaptés.

Sous-agents

Associer les skills à MCP

Les skills définissent des workflows réutilisables, et MCP les connecte à des outils et systèmes externes. Si un skill dépend de MCP, déclarez cette dépendance dans agents/openai.yaml pour que Codex puisse l’installer et configurer la connexion automatiquement (voir Créer des skills).

Étape suivante

Procédez dans cet ordre :

1. Définissez des instructions personnalisées avec AGENTS.md pour que Codex respecte les conventions de votre dépôt. Ajoutez des hooks de pré-commit et des linters pour faire appliquer ces règles.
2. Installez un plugin si un workflow réutilisable existe déjà. Sinon, créez un skill et distribuez-le sous forme de plugin lorsque vous souhaitez le partager.
3. Utilisez MCP lorsque vos workflows nécessitent des systèmes externes (Linear, GitHub, serveurs de documentation, outils de design).
4. Faites appel à des sous-agents lorsque vous souhaitez leur déléguer des tâches spécialisées ou qui risquent d’encombrer la discussion principale.