Personnaliser les réponses GitHub Copilot Chat

6 minutes

GitHub Copilot Chat peut générer des réponses et du code qui correspondent à vos pratiques de codage et exigences de projet en fonction du contexte approprié. Au lieu d’ajouter à plusieurs reprises ces informations dans chaque invite de conversation, vous pouvez stocker ce contexte dans les fichiers et l’inclure automatiquement dans chaque demande de conversation.

Il existe trois façons principales de personnaliser les réponses IA dans Visual Studio Code :

Instructions personnalisées : Définissez des instructions courantes pour les tâches telles que la génération de code, l’exécution de révisions de code ou la génération de messages de validation. Celles-ci décrivent comment les tâches doivent être effectuées et peuvent spécifier des pratiques de codage, des technologies préférées, des règles de sécurité ou des formats de message de validation.
Fichiers d’invite : définissez des invites réutilisables pour les tâches courantes. Ces requêtes autonomes décrivent ce qui doit être effectué et peuvent inclure des composants de génération automatique de modèles, effectuer des révisions de code, créer des guides pratiques ou générer des plans d’implémentation.
Modes de conversation personnalisés : définissez le fonctionnement de la conversation, les outils qu’il peut utiliser et la façon dont il interagit avec le codebase. Par exemple, les modes de planification avec un accès en lecture seule, les modes de recherche accédant aux ressources externes ou les modes spécifiques au rôle, comme le développement front-end.

Instructions personnalisées

Les instructions personnalisées vous permettent de décrire les instructions qui obtiennent des réponses correspondant à vos pratiques de codage spécifiques et à votre pile technique. Au lieu d’inclure manuellement ce contexte dans chaque requête de conversation, les instructions personnalisées incorporent automatiquement ces informations à chaque demande de conversation.

Note

Les instructions personnalisées ne sont pas prises en compte pour la saisie semi-automatique du code.

Types d’instructions personnalisées

Visual Studio Code prend en charge trois façons de définir des instructions personnalisées :

Type	Description	Cas d’usage
`.github/copilot-instructions.md`	Fichier Markdown unique dans l’espace de travail, inclus automatiquement dans toutes les demandes, prise en charge inter-éditeur.	Pratiques de codage générales, technologies préférées, exigences à l’échelle du projet.
`.instructions.md files`	Plusieurs fichiers Markdown avec prise en charge des modèles Glob, un espace de travail ou un stockage de profil utilisateur.	Instructions spécifiques à la tâche, contrôle granulaire sur le moment où les instructions s’appliquent.
paramètres de Visual Studio Code	Instructions dans les paramètres utilisateur/espace de travail pour des scénarios spécifiques.	Génération de code, génération de tests, messages de validation, révisions de code, descriptions de demande de tirage (pull request).

Vous pouvez combiner ces approches, mais éviter les instructions en conflit, car aucun ordre de priorité n’est appliqué.

Exemples d’instructions personnalisées

Instructions générales en matière de codage :

---
applyTo: "**"
---
# Project coding standards

## Naming Conventions
- Use PascalCase for component names, interfaces, and type aliases.
- Use camelCase for variables, functions, and methods.
- Prefix private class members with underscore (_).
- Use ALL_CAPS for constants.

## Error Handling
- Use try/catch blocks for async operations.
- Implement proper error boundaries in React components.
- Always log errors with contextual information.

Instructions TypeScript et React :

---
applyTo: "**/*.ts,**/*.tsx"
---
# TypeScript and React standards

Apply the [general coding guidelines](./general-coding.instructions.md) to all code.

## TypeScript Guidelines
- Use TypeScript for all new code.
- Follow functional programming principles where possible.
- Use interfaces for data structures and type definitions.
- Prefer immutable data (const, readonly).
- Use optional chaining (?.) and nullish coalescing (??) operators.

## React Guidelines
- Use functional components with hooks.
- Follow the React hooks rules (no conditional hooks).
- Use React.FC type for components with children.
- Keep components small and focused.
- Use CSS modules for component styling.

Utiliser le fichier .github/copilot-instructions.md

Stockez des instructions personnalisées dans un .github/copilot-instructions.md fichier à la racine de votre espace de travail pour décrire les pratiques de codage, les technologies préférées et les exigences de projet. Ces instructions s’appliquent uniquement à l’espace de travail et sont automatiquement incluses dans chaque demande de conversation.

Étapes de configuration :

Vérifiez que github.copilot.chat.codeGeneration.useInstructionFiles est activé (activé par défaut dans les versions récentes de Visual Studio Code).
Créez .github/copilot-instructions.md à la racine de l’espace de travail.
Décrivez les instructions à l’aide du langage naturel et du format Markdown.

Note

Ce fichier fonctionne entre Visual Studio Code, Visual Studio et GitHub.com.

Utiliser des fichiers .instructions.md

Créez plusieurs .instructions.md fichiers pour des tâches spécifiques, des langages de programmation, des frameworks ou des types de projet. Celles-ci peuvent être appliquées automatiquement en fonction de modèles de fichier ou attachées manuellement aux invites de conversation.

Emplacements de fichier :

Fichiers d’espace de travail : stockés dans le .github/instructions dossier, disponibles uniquement dans l’espace de travail.
Fichiers Utilisateur : stockés dans le profil de Visual Studio Code, disponibles dans plusieurs espaces de travail et synchronisés via Synchronisation des Paramètres.

Structure de fichiers :

---
description: "Brief description of the instructions file"
applyTo: "**/*.ts,**/*.tsx"  # Glob pattern for automatic application
---
# Instructions content in Markdown format

Créez et utilisez des fichiers d’instructions :

Exécutez Chat: New Instructions File à partir de la palette de commandes.
Choisissez l’espace de travail ou l’emplacement de l’utilisateur.
Entrez les instructions de nom et d’auteur dans Markdown.
Permet Chat: Configure Instructions de modifier les fichiers existants.

Attachement manuel :

En mode Conversation : Ajouter des instructions contextuelles >
Palette de commandes : Chat: Attach Instructions

Application automatique : utiliser des applyTo métadonnées avec des modèles glob (** pour toutes les demandes, des modèles spécifiques pour l’application ciblée)

Spécifier des instructions personnalisées dans les paramètres

Configurez des instructions personnalisées dans les paramètres Visual Studio Code pour des scénarios spécifiques :

Scenario	Setting
Génération de code	`github.copilot.chat.codeGeneration.instructions`
Génération de test	`github.copilot.chat.testGeneration.instructions`
Révision du code	`github.copilot.chat.reviewSelection.instructions`
Messages de validation	`github.copilot.chat.commitMessageGeneration.instructions`
Titres/descriptions des PR	`github.copilot.chat.pullRequestDescriptionGeneration.instructions`

Définissez des instructions en tant que fichiers externes de texte ou de référence :

"github.copilot.chat.codeGeneration.instructions": [
  {
    "text": "Always add a comment: 'Generated by Copilot'."
  },
  {
    "text": "In TypeScript always use underscore for private field names."
  },
  {
    "file": "general.instructions.md"
  },
  {
    "file": "db.instructions.md"
  }
]

Meilleures pratiques pour les instructions personnalisées

Gardez les instructions concises : chaque instruction doit être une instruction unique et simple.
Évitez les références externes : ne faites pas référence à des normes ou ressources de codage externes.
Organiser par rubrique : fractionnez les instructions en plusieurs fichiers pour une meilleure organisation.
Activer le partage d’équipe : stocker des instructions dans les fichiers contrôlés par la version pour la collaboration d’équipe.
Utiliser l’application ciblée : tirez parti de applyTo la propriété pour obtenir des instructions spécifiques aux fichiers.
Référencez efficacement : référencez des instructions personnalisées dans les fichiers d’invite pour éviter la duplication.

Fichiers de prompt

Les fichiers d'invite sont des invites de tâche autonomes et réutilisables stockées sous forme de fichiers .prompt.md. Contrairement aux instructions personnalisées, qui décrivent comment GitHub Copilot doit répondre, les fichiers d’invite décrivent ce qui doit être effectué pour une tâche spécifique. Vous les exécutez à la demande plutôt que de les faire appliquer automatiquement à chaque demande.

Les fichiers d'invite conviennent parfaitement aux workflows récurrents de vibe coding : création de la structure d'un nouveau composant, génération d'une première version d'un document d'exigences produit, exécution d'une passe de revue de code ou lancement d'une session avec le contexte de votre projet déjà chargé.

Créer un fichier de commande

Stockez les fichiers d’invite dans le .github/prompts/ dossier de votre espace de travail. Le nom du fichier devient le nom du prompt.

Structure de fichiers :

---
mode: "ask"
description: "Generate a product requirements document for a new feature"
---
# Generate a PRD

Create a product requirements document for the described feature.

Include the following sections:
- Product summary
- Target audience
- Core features (prioritized by must-have / should-have / could-have)
- Out of scope
- Technical requirements

Feature description: ${input:Feature description}

Exécuter un fichier d'invite

Palette de commandes : exécutez Chat: Run Prompt et sélectionnez le fichier.
Entrée de chat : tapez # dans la vue de conversation et sélectionnez le fichier de commande par son nom.

Les fichiers d'invite prennent en charge les valeurs mode de ask, edit et agent. Ils peuvent également référencer vos fichiers d’instructions personnalisées à l’aide de la syntaxe de lien Markdown pour éviter de dupliquer du contenu entre les fichiers.

Modes de conversation personnalisés

Les modes de conversation personnalisés vous permettent de configurer le mode de fonctionnement du panneau gitHub Copilot Chat pour un flux de travail spécifique. Vous définissez les outils disponibles, la façon dont l’IA interagit avec votre codebase et le rôle qu’elle doit jouer, sans modifier vos instructions personnalisées.

Pour le codage d’ambiance, cela est particulièrement utile pour séparer la phase de planification de la phase de construction . Un mode de planification peut restreindre GitHub Copilot à l’analyse en lecture seule afin qu’il propose des conceptions sans apporter de modifications, tandis qu’un mode d’implémentation déverrouille les outils d’édition complets.

Créer un mode de conversation personnalisé

Stockez les fichiers en mode conversation personnalisé dans le .github/chatmodes/ dossier de votre espace de travail.

Structure de fichiers :

---
description: "Plan mode: read-only analysis and architecture decisions"
tools: []
---
You are a software architect in planning mode. Analyze the codebase, identify patterns, suggest designs, and answer questions — but do not make any code changes.

Configurations courantes du mode conversation pour le codage vibe :

Mode	Outils	Cas d’utilisation
Planification	Aucun (lecture seule)	Décisions d’architecture, conception de fonctionnalités, révision PRD
Recherche	Recherche Web	Examen des bibliothèques, comparaison des approches
Mise en œuvre	Accès complet aux outils	Écriture et modification de code, exécution de commandes
Révision	Lecture seule	Révision du code, audit de sécurité, vérification des performances

Utiliser un mode de conversation personnalisé

Sélectionnez le mode dans le sélecteur de mode de chat de la barre d'outils de l'affichage Chat. Le mode persiste pour la session jusqu’à ce que vous changiez de mode.

Summary

La personnalisation des réponses de GitHub Copilot vous permet d'adapter l'assistance IA à votre flux de travail spécifique. Instructions personnalisées — utilisant des fichiers .github/copilot-instructions.md, des fichiers .instructions.md, ou les paramètres de Visual Studio Code — définissent comment GitHub Copilot doit répondre, intégrant vos pratiques, normes et préférences de codage. Les fichiers d’invite définissent ce qui doit être fait pour les tâches récurrentes, ce qui vous donne des invites réutilisables que vous pouvez exécuter à la demande. Les modes de conversation personnalisés configurent le fonctionnement de la session de conversation, ce qui vous permet de basculer entre la planification, la recherche, l’implémentation et les workflows de révision sans modifier vos instructions sous-jacentes. Ensemble, ces trois outils vous aident à créer un environnement cohérent de codage vibe où GitHub Copilot comprend votre projet dès le début.

Commentaires

Cette page a-t-elle été utile ?