Ce tutoriel de démarrage rapide vous guide pour la personnalisation d’un référentiel GitHub Copilot. À la fin, Copilot connaîtra les conventions de votre projet, disposera d’un agent spécialisé pour les tâches courantes et aura structuré le contexte du projet.
**Scénario:** Vous travaillez sur le référentiel d’applications web d’une équipe avec une suite de tests établie, des conventions de codage et des problèmes actifs. Vous souhaitez Copilot travailler efficacement avec la base de code dès le premier jour.
Prerequisites
- Plan Copilot qui inclut Agent cloud Copilot (GitHub Copilot Pro+, Copilot Businessou Copilot Entreprise). Pour plus d’informations, consultez « Plans de GitHub Copilot ».
- Agent de cloud activé pour votre organisation ou votre compte. Pour plus d’informations, consultez « Gestion de l’accès à GitHub Copilot agent cloud ».
- Accès en écriture à un GitHub référentiel.
Étape 1 : Enseigner les Copilot conventions de votre projet
Les instructions personnalisées du référentiel fournissent un Copilot contexte persistant sur votre projet , sa structure, ses normes de codage et la façon de générer et de tester du code. Chaque Copilot interaction dans le référentiel utilise automatiquement ces instructions.
Demandez à Agent cloud Copilot de générer un fichier copilot-instructions.md :
-
Allez à github.com/copilot/agents.
-
Sélectionnez votre dépôt dans le menu déroulant du champ de saisie.
-
Entrez l’invite suivante :
Text Onboard this repository to Copilot cloud agent by adding a .github/copilot-instructions.md file. Include information about project structure, coding conventions, the test framework, and how to build and run the project.
Onboard this repository to Copilot cloud agent by adding a .github/copilot-instructions.md file. Include information about project structure, coding conventions, the test framework, and how to build and run the project. -
Passez en revue le fichier généré et fusionnez le pull request.
Copilot comprend désormais les conventions de votre projet dans les sessions de conversation, de révision de code et d’agent. Consultez « [AUTOTITLE](/copilot/how-tos/copilot-on-github/customize-copilot/add-custom-instructions/add-repository-instructions) ».
Étape 2 : Créer un agent spécialisé
Agents personnalisés vous permet de créer des assistants ciblés pour les tâches périodiques. Dans cet exemple, créez un agent qui diagnostique et corrige les bogues.
-
Accédez à github.com/copilot/agents et sélectionnez votre référentiel.
-
Dans le champ d’invite, cliquez sur . Cliquez ensuite sur Créer un agent personnalisé.
-
Renommez le fichier en
bug-fixer.agent.md. -
Remplacez le contenu du modèle par :
YAML --- name: Bug Fixer description: Diagnoses and fixes bugs reported in GitHub issues. tools: - read - edit - terminal - search --- You are a bug-fixing specialist. When given a bug report or issue: 1. Reproduce the bug by writing a failing test. 2. Identify the root cause. 3. Fix the code. 4. Verify the fix passes the test and doesn't break existing tests. Always follow the project's testing conventions and coding standards.
--- name: Bug Fixer description: Diagnoses and fixes bugs reported in GitHub issues. tools: - read - edit - terminal - search --- You are a bug-fixing specialist. When given a bug report or issue: 1. Reproduce the bug by writing a failing test. 2. Identify the root cause. 3. Fix the code. 4. Verify the fix passes the test and doesn't break existing tests. Always follow the project's testing conventions and coding standards. -
Validez le fichier et fusionnez-le dans la branche par défaut.
Votre agent de correctif de bogue s’affiche désormais dans la liste déroulante des agents sous l’onglet Agents. Sélectionnez-le avant de coller une URL de problème pour démarrer une session de débogage prioritaire. Consultez « Création d’agents personnalisés pour Agent cloud Copilot ».
Étape 3 : Organiser le contexte du projet avec un espace
Copilot Spaces vous permet de constituer le contexte exact dont Copilot a besoin pour une zone spécifique de votre projet. Les réponses sont ancrées dans les fichiers, problèmes et documentation pertinents.
-
Accédez à github.com/copilot/spaces , puis cliquez sur Créer un espace.
-
Nommez l’espace (par exemple, « Architecture API ») et choisissez un propriétaire.
-
Cliquez sur Ajouter des sources, puis ajoutez un contexte pertinent pour votre projet : * ** Ajouter des fichiers et des référentiels** : ajoutez des documents d’architecture, des schémas d’API ou des fichiers de configuration de clé. * ** Lier des fichiers, des pull requests et des problèmes** : collez les URL des problèmes actifs ou des discussions de conception.
-
Dans la conversation de l’espace, posez une question comme : « Quels modèles notre API utilise-t-elle pour la gestion des erreurs ? »
Copilot réponses utilisant uniquement le contexte que vous avez organisé. Consultez « [AUTOTITLE](/copilot/how-tos/copilot-on-github/customize-copilot/copilot-spaces/create-copilot-spaces) ».
Étapes suivantes
[AUTOTITLE](/copilot/how-tos/copilot-on-github/customize-copilot/add-custom-instructions/add-personal-instructions)** : définissez les préférences personnelles qui s’appliquent à tous vos référentiels.
[AUTOTITLE](/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/add-skills)** : ajoutez de nouvelles fonctionnalités à vos agents.
[AUTOTITLE](/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/extend-cloud-agent-with-mcp)** : connecter des agents à des outils et services externes.
[AUTOTITLE](/copilot/how-tos/copilot-on-github/customize-copilot/copilot-spaces/collaborate-with-others)** : partagez vos espaces avec vos collègues.