Règles et instructions Officiel

GitHub Copilot custom instructions

Instructions de dépôt pour GitHub Copilot : copilot-instructions.md, fichiers par chemin, AGENTS.md.

Auteur: GitHub
Compatible avec: GitHub Copilot
Documenté: Oct 2, 2026

Ce qu'est GitHub Copilot custom instructions

Les instructions personnalisées de dépôt donnent à Copilot des consignes propres au dépôt sur GitHub. Trois types sont pris en charge : à l'échelle du dépôt, par chemin et instructions d'agent.

Ce qu'il fait

Où GitHub Copilot custom instructions s'exécute et ce qu'il ajoute, d'après sa documentation

Instructions à l'échelle du dépôt dans .github/copilot-instructions.md
Instructions par chemin dans NAME.instructions.md sous .github/instructions
Instructions d'agent via des fichiers AGENTS.md n'importe où ; le plus proche l'emporte
Ou bien un seul CLAUDE.md ou GEMINI.md à la racine du dépôt
L'agent cloud Copilot peut générer un copilot-instructions.md à partir d'un prompt

Quand l'utiliser

Bonne adéquation

Vous voulez que Copilot suive les étapes de build et de validation du repo
Différents chemins demandent des consignes Copilot différentes

Pas pour

Instructions propres à une tâche : le prompt de génération de GitHub indique que les instructions ne doivent pas être spécifiques à une tâche

Comment installer GitHub Copilot custom instructions

Il vous faut : GitHub Copilot; Pour la revue de code, paramètre personnel d'instructions personnalisées activé (par défaut)

Créez .github/copilot-instructions.md dans le dépôt
Rédigez un résumé du repo et les étapes de build, de test et de validation
Pour des règles par chemin, ajoutez des fichiers NAME.instructions.md sous .github/instructions
Ou demandez à l'agent cloud Copilot sur github.com/copilot/agents de générer le fichier
Commitez les fichiers dans le dépôt

Limites

Le prompt de génération de GitHub demande des instructions de 2 pages au maximum
La prise en charge des fonctionnalités varie selon le type ; voir la vue d'ensemble de la personnalisation de GitHub

Outils qu'il étend

Programmation Offre gratuite

GitHub Copilot

Web · Desktop · Mobile

Pas encore d'avis d'utilisateurs

Assistant de codage IA de GitHub proposant complétions de code, chat et fonctions d'agent dans les éditeurs, le terminal et GitHub.

La gratuité s'arrête à : 2,000 completions per month, Limited chat and agent usage (allowance of GitHub AI Credits)

Listed Pas encore évalué

Vérifié Sep 30, 2026 github.com (ouvre le site de GitHub Copilot dans un nouvel onglet)

Gratuit · payant dès $10/mo US · vérifié Sep 30

CompareAdded Détails

Questions fréquentes

Où placer le fichier d'instructions Copilot à l'échelle du dépôt ?

.github/copilot-instructions.md dans le dépôt. source

Comment écrire des instructions Copilot par chemin ?

Créez des fichiers NAME.instructions.md dans .github/instructions ou ses sous-dossiers. source

Copilot lit-il AGENTS.md ?

Oui, les instructions d'agent utilisent AGENTS.md ; le fichier le plus proche est prioritaire. Un CLAUDE.md ou GEMINI.md à la racine fonctionne aussi. source

Les instructions par chemin et à l'échelle du dépôt se combinent-elles ?

Oui, lorsqu'un chemin correspond et qu'un fichier à l'échelle du dépôt existe, les deux sont utilisés. source

Sources et lacunes

https://docs.github.com/en/copilot/how-tos/configure-custom-instructions/add-repository-instructions docs, vérifié Oct 2, 2026
https://github.com/github/docs readme, vérifié Oct 2, 2026

Non précisé par les mainteneurs : repo_url est le repo de documentation public de GitHub, pas un repo de règles; github-copilot n'est pas dans notre catalogue.