{"meta":{"title":"Ajout d’instructions personnalisées pour GitHub Copilot CLI","intro":"Donnez un Copilot contexte supplémentaire sur la façon de comprendre votre projet et comment générer, tester et valider ses modifications.","product":"GitHub Copilot","breadcrumbs":[{"href":"/fr/enterprise-cloud@latest/copilot","title":"GitHub Copilot"},{"href":"/fr/enterprise-cloud@latest/copilot/how-tos","title":"Procédures"},{"href":"/fr/enterprise-cloud@latest/copilot/how-tos/copilot-cli","title":"Copilot CLI"},{"href":"/fr/enterprise-cloud@latest/copilot/how-tos/copilot-cli/customize-copilot","title":"Personnaliser le CLI Copilot"},{"href":"/fr/enterprise-cloud@latest/copilot/how-tos/copilot-cli/customize-copilot/add-custom-instructions","title":"Ajouter des instructions personnalisées"}],"documentType":"article"},"body":"# Ajout d’instructions personnalisées pour GitHub Copilot CLI\n\nDonnez un Copilot contexte supplémentaire sur la façon de comprendre votre projet et comment générer, tester et valider ses modifications.\n\nGitHub Copilot peut fournir des réponses adaptées à vos préférences personnelles, à la façon dont votre équipe fonctionne, aux outils que vous utilisez ou aux spécificités de votre projet, si vous le fournissez avec suffisamment de contexte pour le faire. Au lieu d’ajouter à plusieurs reprises ces détails contextuels à vos demandes, vous pouvez créer des instructions personnalisées qui ajoutent automatiquement ces informations pour vous. Les informations supplémentaires ne sont pas affichées, mais elles sont disponibles pour permettre à Copilot de générer des réponses de meilleure qualité.\n\n## Types d’instructions personnalisées\n\nGitHub Copilot CLI prend en charge les instructions provenant des emplacements suivants.\n\nSauf indication contraire dans le tableau ci-dessous, Copilot CLI découvre les fichiers d’instructions du référentiel et de l’agent dans les **emplacements standard** : la racine du référentiel, le répertoire de travail actif, les répertoires intermédiaires entre eux et tous les répertoires imbriqués dans le chemin d’accès d’un fichier sur lequel il fonctionne. Les fichiers d’instructions modulaires (ceux correspondants `*.instructions.md`) sont spécifiques au chemin d’accès, un fichier avec une `applyTo` valeur s’applique uniquement aux fichiers correspondants.\n\n| Lieu                                                            | Étendue et comportement                                                                                                                                                        |\n| --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| `$HOME/.copilot/copilot-instructions.md`                        | Instructions propres à l’utilisateur qui s’appliquent à tous les dépôts.                                                                                                       |\n| `$HOME/.copilot/instructions/**/*.instructions.md`              | Instructions modulaires au niveau de l’utilisateur.                                                                                                                            |\n| `.github/copilot-instructions.md`                               | Instructions valables pour l’ensemble du dépôt, trouvées dans les emplacements standard.                                                                                       |\n| `.github/instructions/**/*.instructions.md`                     | Instructions de référentiel modulaire, découvertes dans les emplacements standard, mais pas dans les répertoires intermédiaires.                                               |\n| `AGENTS.md`                                                     | Instructions de l’agent, découvertes dans les emplacements standard. Pour plus d’informations, consultez le [dépôt agentsmd/agents.md](https://github.com/agentsmd/agents.md). |\n| `CLAUDE.md`                                                     | Instructions de l’agent, découvertes dans les emplacements standard.                                                                                                           |\n| Copilot CLI utilise `.claude/CLAUDE.md`également .              |                                                                                                                                                                                |\n| `GEMINI.md`                                                     | Instructions de l’agent, découvertes dans les emplacements standard.                                                                                                           |\n| Répertoires répertoriés dans `COPILOT_CUSTOM_INSTRUCTIONS_DIRS` | Fichiers `AGENTS.md` et `*.instructions.md` supplémentaires. Séparez plusieurs répertoires par des virgules.                                                                   |\n\nSi vous définissez la variable d’environnement `COPILOT_HOME`, Copilot CLI utilise ce répertoire à la place de `$HOME/.copilot` pour les deux emplacements des instructions au niveau utilisateur.\n\nUtilisez la `/instructions` commande pour afficher les fichiers d’instructions découverts pour la session active et activer ou désactiver des fichiers individuels.\n\n## Interaction de plusieurs fichiers d’instructions\n\nLorsque plusieurs fichiers d’instructions de niveau utilisateur et de référentiel applicables existent, Copilot CLI combine leurs instructions. Il supprime les copies en double des instructions identiques au niveau de l’utilisateur, au niveau `copilot-instructions.md`du référentiel et de l’agent, mais ne définit pas d’ordre de priorité générale entre ces fichiers. Évitez les instructions en conflit.\n\nLes instructions spécifiques au chemin d’accès sont incluses uniquement lorsque leur `applyTo` valeur correspond à un fichier qui Copilot CLI fonctionne avec. Un fichier d’instructions que vous désactivez à l’aide de `/instructions` n’est pas inclus.\n\n## Création d’instructions personnalisées à l’échelle du dépôt\n\n1. À la racine de votre référentiel, créez un fichier nommé `.github/copilot-instructions.md`.\n\n   Créez le répertoire `.github` s’il n’existe pas déjà.\n\n2. Ajouter des instructions en langage naturel dans le fichier, au format Markdown.\n\n   L’espacement entre les instructions est ignoré, de sorte que les instructions peuvent être écrites dans un seul paragraphe, chacune sur une nouvelle ligne, ou séparées par des lignes vides pour plus de lisibilité.\n\n   Pour obtenir de l’aide sur l’écriture d’instructions personnalisées efficaces, consultez [À propos de la personnalisation des réponses GitHub Copilot](/fr/enterprise-cloud@latest/copilot/concepts/prompting/response-customization#writing-effective-custom-instructions).\n\n### Référencement d’autres fichiers\n\nDans `.github/copilot-instructions.md`, `AGENTS.md`ou , `CLAUDE.md` utilisez `@`suivi d’un chemin relatif pour inclure un autre fichier.\nCopilot CLI lit immédiatement le fichier référencé et prend en charge les références dans les fichiers référencés.\n\nLes fichiers référencés doivent rester dans le référentiel ou dans le répertoire d’instructions personnalisées pour obtenir des instructions locales. Les chemins absolus et les chemins commençant par `~/` ne sont pas chargés. Les références de fichier ne sont pas développées dans les fichiers `GEMINI.md` ou `*.instructions.md`.\n\n## Création d’instructions personnalisées spécifiques à un chemin\n\n1. Créez le `.github/instructions` répertoire s'il n'existe pas déjà.\n\n2. Si vous le souhaitez, créez des sous-répertoires de `.github/instructions` pour organiser vos fichiers d’instructions.\n\n3. Créez un ou plusieurs fichiers `NAME.instructions.md`, où `NAME` indique l’objectif des instructions. Le nom de fichier doit se terminer par `.instructions.md`.\n\n4. Au début du fichier, créez un bloc frontmatter contenant le mot-clé `applyTo`. Utilisez la syntaxe glob pour spécifier les fichiers ou répertoires auxquels les instructions s’appliquent.\n\n   Par exemple :\n\n   ```markdown\n   ---\n   applyTo: \"app/models/**/*.rb\"\n   ---\n   ```\n\n   Vous pouvez spécifier plusieurs modèles en les séparant par des virgules. Par exemple, pour appliquer les instructions à tous les fichiers TypeScript du référentiel, vous pouvez utiliser le bloc frontmatter suivant :\n\n   ```markdown\n   ---\n   applyTo: \"**/*.ts,**/*.tsx\"\n   ---\n   ```\n\n   Exemples Glob :\n\n   * `*` - correspond à tous les fichiers du répertoire en cours.\n   * `**` ou `**/*` - correspond à tous les fichiers de tous les répertoires.\n   * `*.py` - correspond à tous les `.py` fichiers du répertoire actif.\n   * `**/*.py` - correspond de manière récursive à tous les `.py` fichiers de tous les répertoires.\n   * `src/*.py` - correspond à tous les `.py` fichiers du `src` répertoire. Par exemple, `src/foo.py` et `src/bar.py` mais *pas*`src/foo/bar.py`.\n   * `src/**/*.py` - correspond de manière récursive à tous les `.py` fichiers du `src` répertoire. Par exemple, `src/foo.py`, `src/foo/bar.py`et `src/foo/bar/baz.py`.\n   * ```\n               `**/subdir/**/*.py` - correspond de manière récursive à tous les `.py` fichiers d’un répertoire à n’importe quelle `subdir` profondeur. Par exemple, `subdir/foo.py`, `subdir/nested/bar.py`, `parent/subdir/baz.py` et `deep/parent/subdir/nested/qux.py`, mais _pas_`foo.py` à un chemin qui ne contient pas de répertoire `subdir`.\n     ```\n\n5. Si vous le souhaitez, pour empêcher l’utilisation du fichier par Copilot cloud agent ou Copilot code review, ajoutez le mot clé `excludeAgent` au bloc frontmatter. Utilisez l’une ou l’autre `\"code-review\"` ou `\"cloud-agent\"`.\n\n   Par exemple, le fichier suivant est lu uniquement par Copilot cloud agent.\n\n   ```markdown\n   ---\n   applyTo: \"**\"\n   excludeAgent: \"code-review\"\n   ---\n   ```\n\n   Si le mot clé `excludeAgent` n’est pas inclus dans le front matterblock, Copilot code review et Copilot cloud agent utiliseront vos instructions.\n\n6. Ajoutez vos instructions personnalisées en langage naturel à l’aide du format Markdown. L'espacement entre les instructions est ignoré, de sorte que les instructions peuvent être écrites comme un seul paragraphe, chacune sur une nouvelle ligne, ou séparées par des lignes vides pour plus de lisibilité.\n\n## Instructions personnalisées en cours d’utilisation\n\nLes modifications apportées aux fichiers d’instructions personnalisées ne sont pas immédiatement disponibles pour une utilisation dans les sessions CLI actives. Pour appliquer vos modifications, quittez la session active, puis reprenez-la (par exemple, exécutez `copilot --continue`) ou démarrez une nouvelle session (par exemple, utilisez-la `/new` à partir d’une session interactive).\n\n## Lectures complémentaires\n\n* [Prise en charge de différents types d’instructions personnalisées](/fr/enterprise-cloud@latest/copilot/reference/custom-instructions-support)\n* [Instructions personnalisées](/fr/enterprise-cloud@latest/copilot/tutorials/customization-library/custom-instructions) : collection organisée d’exemples\n* [Utilisation d'instructions personnalisées pour exploiter le potentiel de la révision de code avec Copilot.](/fr/enterprise-cloud@latest/copilot/tutorials/customize-code-review)"}