Amélioration de la qualité du code récemment fusionné avec l’IA

Présentation

Ce tutoriel vous montre comment explorer et corriger les problèmes de qualité détectés par Code Qualityl’analyse basée sur l’IA du code récemment fusionné dans votre branche par défaut.

Lorsque vous améliorez la qualité des fichiers récemment fusionnés, vous réduisez la dette technique dans le référentiel et facilitez le travail d’autres développeurs sur des fichiers qui sont en cours de développement actif.

          Code Quality a deux lignes de défense

          Code Quality analyse les demandes de tirage et les commentaires sur les problèmes de qualité, **puis exécute une deuxième analyse IA** une fois la demande de tirage fusionnée. Les deux types d’analyse utilisent des technologies complémentaires :

•           **Les analyses de demande de tirage** utilisent CodeQL des règles pour identifier les problèmes. Cette analyse est soigneusement testée, bonne pour identifier où le code ne correspond pas aux règles de qualité et peut analyser de nombreux fichiers. Toutefois, il prend en charge un sous-ensemble de langages de codage et ne peut pas identifier les problèmes où il n’existe aucune règle.
  

• Les analyses de fichiers récemment fusionnés utilisent un modèle de langage volumineux pour examiner vos fichiers les plus récemment modifiés et présenter les résultats pour jusqu'à 5 fichiers. Cette analyse examine votre code à travers tous les langages de programmation, sans se limiter aux règles, et fournit des aperçus contextuels et des suggestions pouvant aller au-delà de ce que les règles CodeQL offrent.

Prerequisites

• Code Quality est activé, consultez Activation de GitHub Code Quality.
• Au moins une pull request a été fusionnée depuis que Code Quality a été activé.

1. Afficher les suggestions d’IA pour votre référentiel

Après une Code Quality analyse des fichiers récemment fusionnés sur votre branche par défaut, vous pouvez voir les résultats dans l'affichage Résultats de l’IA, qui affiche les résultats pour jusqu'à 5 fichiers.

1. Accédez à l’onglet Security and quality de votre référentiel.
2. Cliquez pour développer Qualité du code, puis cliquez Résultats de l’IA.

2. Explorer les améliorations suggérées pour votre référentiel

Sur la Résultats de l’IA page, chaque fichier est répertorié avec le nombre de problèmes de qualité identifiés et lorsque le fichier a été envoyé à la branche par défaut.

• Cliquez sur un nom de fichier pour afficher les détails des problèmes de qualité détectés et les correctifs suggérés.

3. Déléguer le travail de correction ou ouvrir des pull requests vous-même

Vous pouvez ouvrir une pull request pour appliquer les corrections automatiques suggérées à un fichier ou déléguer le travail de correction à Agent cloud Copilot. Vous avez besoin d’une licence pour affecter du Copilot travail à Agent cloud Copilot.
S’inscrire Copilot

Déléguer le travail à Agent cloud Copilot

Vous pouvez demander à agent de cloud d'ouvrir des requêtes de tirage pour utiliser les modifications suggérées comme incitation à apporter des améliorations aux fichiers. Il s’agit de la meilleure option si vous trouvez que les modifications suggérées sont correctes et que vous souhaitez ouvrir une pull request qui applique des correctifs à plusieurs fichiers.

Pour déléguer la création d’une pull request :

• Plusieurs fichiers : Sélectionnez les fichiers à inclure, puis cliquez sur Assigner la sélection à Copilot dans l’en-tête de la liste des fichiers.

•           **Un fichier :** Cliquez sur **Affecter pour Copilot** le fichier.
  

Il y a un délai pendant la agent de cloud mise en place du travail. Lorsque la demande de tirage est ouverte et que le travail est en cours, une bannière s’affiche avec un lien vers la demande de tirage.

Vous pouvez suivre Agent cloud Copilotle travail :

• Dans le pull request, le résumé est mis à jour à mesure de l'avancement du travail.
• Utilisation de la page des agents ou des journaux de session. Consultez Suivi des sessions de GitHub Copilot.

Ouvrez vos propres pull requests

Vous pouvez ouvrir vous-même des 'pull requests' pour appliquer des suggestions de correction automatique. Il s’agit de la meilleure option si :

• Vous souhaitez travailler sur les modifications localement ou dans GitHub Desktop avant d’ouvrir une requête de tirage.
• Vous n’avez pas accès à Agent cloud Copilot

Ouverture d’une demande de tirage (pull request)

1. Cliquez sur le nom du fichier pour afficher les détails des problèmes de qualité détectés.

2. Passez en revue les problèmes et les correctifs suggérés.

3. Déroulez la liste Attribuer à Copilot, puis cliquez sur Ouvrir une pull request pour sélectionner l'option par défaut « Ouvrir une pull request ». Votre préférence est mémorisée.

   

4. Cliquez sur Ouvrir une pull request pour ouvrir une boîte de dialogue d’options de validation.

5. Cliquez sur Valider la modification pour créer une demande de tirage avec les correctifs.

4. Fournir aux réviseurs de la requête de tirage un contexte

Fournir un contexte sur pourquoi vous proposez des modifications au code est le meilleur moyen d’encourager les membres de l’équipe à examiner votre pull request. Si vous avez utilisé Agent cloud Copilot, le résumé de la pull request inclut déjà tous les détails des problèmes résolus par la pull request.

Si vous avez ouvert la pull request directement à partir de la vue GitHub Code Quality, le résumé de cette pull request est lié à la vue «Résultats de l’IA». Vous pouvez copier certaines des explications de la vue Résultats de l’IA dans le résumé de la requête de tirage.

5. Observez l'impact de vos modifications sur Résultats de l’IA

Lorsque vous revenez à la vue «Résultats de l’IA» après la fusion de votre pull request, les problèmes que vous avez corrigés ne sont plus affichés.

Étapes suivantes

• Découvrez comment Agent cloud Copilot peut aider à accélérer les tâches de développement. Consultez Bonnes pratiques pour l’utilisation de GitHub Copilot pour travailler sur des tâches.
• Donnez des commentaires sur GitHub Code Quality dans la discussion communautaire.