Après avoir utilisé l'application Codex pendant un certain temps, vous avez peut-être rencontré des frustrations similaires : devoir répéter vos préférences de base à chaque nouvelle conversation, ou voir Codex exécuter accidentellement des commandes système au-delà de vos attentes.
L'essence de ces points de douleur fréquents est que votre Codex manque d'une mémoire stable à long terme. Pour résoudre complètement ces communications inefficaces et répétitives, vous devez lui construire un système de mémoire complet.
Cet article vous explique comment configurer AGENTS.md et la fonctionnalité Mémoires pour doter Codex d'une mémoire persistante, lui permettant de vraiment comprendre vos intentions et d'atteindre des gains d'efficacité.
1. AGENTS.md
1. Qu'est-ce que c'est ?
AGENTS.md est un ensemble d'instructions de règles pré-écrites que Codex lit automatiquement à chaque démarrage.
Sans AGENTS.md, Codex démarre chaque fois comme une ardoise vierge – il ne connaît pas vos habitudes de travail, le contexte du projet, ni les limites d'exécution des opérations.
Une fois les règles pertinentes configurées, ces contextes deviennent permanents et vous n'aurez plus jamais à expliquer le même problème.
2. Comment le configurer et l'utiliser
1️⃣ Couche globale : stockée dans le répertoire ~/.codex/AGENTS.md sur votre ordinateur local, applicable à tous vos projets. Idéale pour écrire vos préférences personnelles globales et les règles générales.
Dans l'application Codex, cela correspond à la section « Instructions personnalisées » de la page des paramètres de personnalisation.
Voici un modèle de base recommandé que vous pouvez copier-coller directement à l'emplacement indiqué ci-dessus, puis ajuster en continu selon vos besoins :
1# AGENTS.md23## Comportement de base45- Répondre par défaut en français, sauf si l'utilisateur demande explicitement une autre langue.6- Les réponses doivent être concises et directes, en évitant les remplissages et répétitions inutiles.7- Si la description de la tâche n'est pas claire, demander une confirmation avant de commencer l'exécution.8- Ne pas spéculer activement sur des besoins en dehors de l'intention de l'utilisateur ; ne faire que ce qui est demandé.910## Limites de sécurité1112- Par défaut, lecture seule ; ne pas modifier ou supprimer activement de fichiers sauf instruction explicite de l'utilisateur.13- Avant toute opération irréversible (suppression, écrasement, appel d'API externe pour écrire), une confirmation doit d'abord être obtenue.14- Ne pas afficher de clés, jetons ou informations d'identification sensibles dans la sortie.1516## Normes d'ingénierie1718- Éviter la sur-ingénierie ; ne faire que les modifications explicitement requises ou manifestement nécessaires pour la tâche, en gardant la solution simple.19- Ne pas ajouter de fonctionnalités, de refactorisation de code ou d'optimisations supplémentaires sauf si demandé.20- Ne pas ajouter de commentaires, d'annotations de type ou de docstrings au code non modifié.21- N'ajouter des commentaires que lorsque la logique n'est pas explicite.22- Ne pas ajouter de gestion d'erreurs ou de logique de repli pour des scénarios improbables.23- Ne pas créer de fonctions utilitaires ou de couches d'abstraction utilisées une seule fois.24- Supprimer directement le code confirmé inutile ; ne pas laisser de commentaires explicatifs.
2️⃣ Couche projet : stockée dans le répertoire du projet, principalement utilisée pour personnaliser les règles en fonction du thème et des caractéristiques du projet.
Un bon AGENTS.md au niveau du projet devrait généralement couvrir les aspects suivants :
- Contexte et structure du projet : de quoi s'agit-il et où se trouvent les répertoires importants.
- Méthodes d'exécution : comment démarrer, lancer ou exploiter le projet.
- Normes et contraintes : normes à respecter et choses à ne pas faire explicitement.
- Critères d'achèvement : comment déterminer si une tâche est terminée.
3. Bonnes pratiques pour AGENTS.md
Configurer un AGENTS.md de base n'est que la première étape. Les principes pratiques suivants déterminent le plafond de votre système de mémoire :
1️⃣ Hiérarchisation des règles, responsabilités claires
Dans Codex, AGENTS.md suit le principe de proximité : Sous-répertoire > Répertoire racine > Global. Cela signifie que les règles du répertoire où se trouve le travail en cours ont la priorité la plus élevée.
Cela implique que les règles au niveau du projet remplaceront directement les paramètres globaux du même type. Si toutes les règles sont mélangées, les règles locales de haute priorité peuvent facilement polluer ou détruire accidentellement la logique globale sous-jacente.
Par conséquent, un système de mémoire de règles raisonnable doit suivre le principe de « séparation des préoccupations » : la couche globale ne contient que des règles générales, telles que les préférences linguistiques, les limites de sécurité et les habitudes de comportement de base ; la couche projet contient les spécificités de ce projet, comme les commandes de construction, les conventions de code et les descriptions de modules.
Les deux remplissent leurs rôles respectifs sans interférer, et aucune contradiction n'apparaîtra lors de la fusion.
2️⃣ Commencer par les bases, itérer selon les besoins
AGENTS.md n'a pas besoin d'être écrit en une seule fois. Commencez par les règles les plus essentielles. Lorsque Codex commet la même erreur, demandez-lui directement de revoir et de mettre à jour les règles, par exemple :
"Tu viens de faire la même erreur que la dernière fois. Résume la raison et ajoute l'expérience pertinente dans AGENTS.md."
Ainsi, les règles proviennent toujours de frictions d'utilisation réelles, et AGENTS.md évoluera continuellement avec l'usage.
3️⃣ Rester léger, séparer le contenu complexe
À mesure que l'usage s'approfondit, le contenu d'AGENTS.md peut augmenter. À ce stade, il n'est pas nécessaire de tout entasser dans un seul fichier. Écrivez plutôt le contenu de sujets spécifiques dans des fichiers indépendants, puis référencez-les dans le fichier principal.
Par exemple, écrivez la description de l'architecture du projet séparément dans ARCHITECTURE.md, et incluez simplement une référence d'une ligne dans AGENTS.md :
"Pour l'architecture de base et les spécifications des répertoires de ce projet, veuillez vous référer au fichier ARCHITECTURE.md dans le répertoire actuel."
2. Fonctionnalité Mémoires
En plus de configurer activement les règles pertinentes, Codex prend également en charge une fonctionnalité de mémoire active, qui doit être activée dans Paramètres - Personnalisation - Mémoires, comme illustré ci-dessous :
Après avoir activé le bouton, Codex résumera activement les informations utiles et les préférences clés de la conversation dans la mémoire. Si vous souhaitez voir les mémoires que votre Codex a ajoutées, vous pouvez ouvrir le fichier Memory.md dans ~/.codex/memory pour consulter le contenu des mémoires ajoutées par votre Codex. Voici les miennes :
Pour finir
Construire un système de mémoire est un processus qui évolue avec le temps. Croyez-moi, tant que vous persistez à améliorer et à mettre à jour les règles d'action et à accumuler continuellement des mémoires, Codex deviendra rapidement l'outil de productivité ultime qui vous comprend le mieux et est le plus pratique à utiliser.
