Utilisation de Copilot pour explorer un codebase

Introduction

Si vous avez été affecté à un projet que vous ne connaissez pas bien, ou si vous avez trouvé un projet open source intéressant auquel vous souhaitez contribuer, vous aurez besoin d’une certaine compréhension du codebase avant de pouvoir commencer à apporter des modifications. Ce guide vous montrera comment utiliser GitHub Copilot Chat pour explorer un codebase et vous familiariser rapidement avec le projet.

Utilisation de Copilot Chat

Tout au long de ce guide, nous travaillerons sur GitHub.com, en utilisant Copilot Chat en mode Assistance, qui affiche un panneau Copilot Chat dans le coin inférieur droit de votre page actuelle sur GitHub.com.

Vous pouvez développer le panneau Copilot Chat pour afficher plus d’espace pour les réponses de Copilot en cliquant et en faisant glisser les bords du panneau.

Utilisation des prompts prédéfinis

Copilot Chat est fourni avec un ensemble de prompts prédéfinis qui peuvent vous aider à commencer à explorer un codebase. Vous pouvez utiliser les prompts en cliquant sur un bouton dans le panneau de conversation. Les boutons s’affichent lorsque vous démarrez une nouvelle conversation avec Copilot Chat. La sélection des prompts varie en fonction de la page actuellement affichée sur GitHub.com.

1. Ouvrez le référentiel que vous souhaitez explorer sur GitHub.com.

2. Cliquez sur l’onglet Code pour afficher la page principale du référentiel.

3. Appuyez sur Maj+C pour ouvrir Copilot Chat en mode Assistance.

4. Cliquez sur le bouton Recherche sur ce référentiel dans le panneau de conversation.

   

   Conseil

   Si ce bouton n’apparaît pas, assurez-vous que vous êtes bien sur la page principale du référentiel et cliquez sur le signe plus () en haut à droite du panneau Copilot pour démarrer une nouvelle conversation.

   Un prompt prédéfini est soumis à Copilot et la réponse s’affiche dans le panneau de discussion.

5. Après avoir lu la réponse, vous pouvez également cliquer sur le signe plus () en haut à droite du panneau Copilot pour démarrer une nouvelle conversation, puis cliquer sur Comment démarrer avec ce référentiel.

Exemples d’invites

Les prompts suivants sont des exemples du type de questions que vous pouvez poser à Copilot pour vous aider à en savoir plus sur un codebase.

Questions générales

• Based on the code in this repository, give me an overview of the architecture of the codebase. Provide evidence.

• Which languages are used in this repo? Show the percentages for each language.

• What are the core algorithms implemented in this repo?

• What design patterns are used in this repository? Give a brief explanation of each pattern that you find, and an example of code from this repository that uses the pattern, with a link to the file.

Questions spécifiques

L’utilité de ces questions dépendra du codebase que vous explorez.

• How do I build this project?

• Where is authentication handled in this codebase?

• Analyze the code in this repository and tell me about the entry points for this application.

• Describe the data flow in this application.

• Analyze the code in this repository and tell me what application-level security mechanisms are employed. Provide references.

Comprendre les fichiers dans un répertoire

Utilisez Copilot pour vous aider à comprendre l’objectif des fichiers dans un répertoire ou des fichiers individuels.

Pour en savoir plus sur les fichiers d’un répertoire :

1. Accédez au répertoire sur GitHub.com.
2. Appuyez sur Maj+C pour ouvrir Copilot Chat en mode Assistance.
3. Demandez à Copilot : Explain the files in this directory.

Pour en savoir plus sur un fichier spécifique :

1. Ouvrez le fichier sur GitHub.com.
2. Appuyez sur Maj+C pour ouvrir Copilot Chat en mode Assistance.
3. Pour un petit fichier, demandez à Copilot : Explain this file.
4. Pour un fichier volumineux, demandez : Explain what this file does. Start with an overview of the purpose of the file. Then, in appropriately headed sections, go through each part of the file and explain what it does in detail.

Présentation des lignes de code spécifiques

Utilisez Copilot pour vous aider à comprendre des lignes de code spécifiques dans un fichier.

Pour en savoir plus sur une ligne de code spécifique :

1. Dans GitHub, accédez à un référentiel et ouvrez un fichier.

2. Sélectionnez les lignes en cliquant sur le numéro de ligne de la première ligne que vous souhaitez sélectionner, maintenez la touche Maj enfoncée et cliquez sur le numéro de ligne de la dernière ligne que vous souhaitez sélectionner.

3. Pour poser votre propre question sur les lignes sélectionnées, cliquez sur l'icône Copilot () à droite de votre sélection. Cela affiche le panneau GitHub Copilot Chat avec les lignes sélectionnées indiquées comme contexte de votre question.

4. Pour poser une question prédéfinie, cliquez sur le bouton pointant vers le bas à côté de l’icône de Copilot, puis choisissez l’une des options.

   

5. Si vous avez cliqué sur l’icône Copilot, tapez une question dans la zone de prompt en bas du panneau de conversation et appuyez sur Entrée.

Présentation d’un fichier ou d’un symbole spécifique

Utilisez Copilot pour vous aider à comprendre l'objectif d'un fichier ou d'un symbole spécifique dans la base de code. Un symbole est une entité nommée dans le code, telle qu’une fonction, une classe ou une variable.

1. Accédez à un référentiel dans GitHub.

2. En haut à droite de la page, cliquez sur à côté de l’icône , puis cliquez sur Assistance pour ouvrir le panneau Copilot Chat.

3. Dans la boîte de dialogue, cliquez sur Joindre, puis cliquez sur Fichiers, dossiers et symboles.

4. Recherchez et sélectionnez un ou plusieurs fichiers, dossiers ou symboles.

5. Dans la zone de prompt, tapez une question et appuyez sur Entrée.

   Copilot répond dans le volet de discussion.

   Conseil

   La capacité de Copilot à répondre à des questions en langage naturel comme celles-ci dans le contexte d'un référentiel est optimisée lorsque l'index de recherche de code sémantique pour le référentiel est à jour. Pour plus d’informations, consultez « Indexing repositories for GitHub Copilot Chat ».

En savoir plus sur les commits

Pour vous familiariser avec un projet, vous pouvez notamment consulter les travaux récemment réalisés. Pour ce faire, parcourez les commits récents.

1. Sur GitHub, accédez à la page principale du référentiel.

2. Dans la page principale du dépôt, au-dessus de la liste des fichiers, cliquez sur commits.

   

3. Cliquez sur un message de commit pour afficher une vue diff pour ce commit.

4. Dans le panneau Copilot Chat, entrez : What does this commit do?.

5. Si nécessaire, vous pouvez assurer un suivi en entrant : Explain in more detail.

Utilisation de l’onglet Informations

En plus d’utiliser Copilot pour vous familiariser avec un projet, vous pouvez également utiliser l’onglet Informations sur GitHub.com. Cela vous donne une vue d’ensemble très détaillée du référentiel.

Pour plus d’informations, consultez « Utilisation de Pulsation pour afficher un résumé de l’activité du référentiel » et « Affichage des contributeurs d’un projet ».

Pour aller plus loin

• Asking GitHub Copilot questions in GitHub