Informations de référence sur les scénarios et les compétences

GitHub Copilot agent de modernisation fournit des flux de travail de modernisation managés et de bout en bout appelés scenarios. Chaque scénario vous guide tout au long d’un type spécifique d’activité dans le travail de modernisation C++ pratique. Cette page documente les scénarios et compétences disponibles afin de comprendre ce que l’agent peut faire pour votre projet.

Scenarios

Un scénario est un workflow managé qui vous guide tout au long d’un type spécifique d’activité de modernisation.

Comment les scénarios sont découverts

Vous n’avez pas besoin de mémoriser les noms de scénarios. L’agent détecte votre type de projet et suggère automatiquement le scénario approprié.

Pour répertorier les scénarios pris en charge par l’agent, demandez « Quels scénarios sont disponibles pour mon projet ? » dans la fenêtre de conversation GitHub Copilot.

Scénarios disponibles

Mise à niveau des outils de génération MSVC (MSBuild)

Ce scénario gère le workflow de mise à niveau complet pour les projets C++ basés sur MSBuild :

1. Reciblage : met à jour les paramètres du projet pour cibler les derniers outils de génération MSVC et l’ensemble d’outils de plateforme MSVC.
2. Analyse de la génération : génère la solution et catalogue toutes les erreurs et avertissements introduits par la mise à niveau.
3. Mise à jour du code : remplace les API déconseillées, résout les problèmes de conformité et aide à résoudre les changements cassants.
4. Validation : régénère pour confirmer que tous les problèmes sont résolus.

Par exemple, ce scénario résout des problèmes tels que :

• Fonctions CRT dépréciées, par exemple à sprintfsprintf_s.
• Modification de la conformité C++, par exemple, analyse de modèle plus stricte.
• Modifications de bibliothèque standard entre les versions MSVC, telles que les espaces de noms expérimentaux supprimés (par exemple std::tr1).
• Promotions d’avertissement en tant qu’erreur dans les ensembles d’outils plus récents.
• Erreurs de l’éditeur de liens pour les API supprimées du Kit de développement logiciel (SDK) Windows.

Mise à niveau des outils de génération MSVC (CMake)

Ce scénario gère les flux de travail de mise à niveau pour les projets CMake C++ :

1. Analyse de build : génère le projet et catalogue toutes les erreurs et avertissements introduits par la mise à niveau.
2. Mise à jour du code : remplace les API déconseillées, résout les problèmes de conformité et aide à résoudre les changements cassants.
3. Validation : régénère pour confirmer que tous les problèmes sont résolus.

Par exemple, ce scénario résout des problèmes tels que :

• Fonctions CRT dépréciées, par exemple à sprintfsprintf_s.
• Modification de la conformité C++, par exemple, analyse de modèle plus stricte.
• Modifications de bibliothèque standard entre les versions MSVC, telles que les espaces de noms expérimentaux supprimés (par exemple std::tr1).
• Promotions d’avertissement en tant qu’erreur dans les ensembles d’outils plus récents.
• Erreurs de l’éditeur de liens pour les API supprimées du Kit de développement logiciel (SDK) Windows.

Persistance du scénario

Chaque scénario actif obtient son propre dossier à l’adresse .github/upgrades/{scenarioId}. Le dossier du scénario contient le plan, la progression des tâches, vos préférences et les journaux d’exécution. Le dossier fait partie de votre dépôt Git.

Compétences

Les compétences sont des fonctionnalités de modernisation plus petites et ciblées que l’agent utilise dans un scénario. Lorsque l’agent rencontre un modèle spécifique pendant une mise à niveau, il charge la compétence appropriée avec des instructions détaillées.

Les compétences se chargent automatiquement en fonction de ce que l’agent détecte dans votre codebase. Vous n’avez pas besoin de gérer le chargement de compétences.

Contenu connexe

• GitHub Copilot modernisation pour la vue d’ensemble de C++
• Troubleshoot GitHub Copilot modernisation pour C++