O que é a modernização do GitHub Copilot?

A Modernização do GitHub Copilot é um agente do GitHub Copilot que ajuda você a atualizar e modernizar seus projetos em C++. Ele orienta você por meio de avaliação, recomendações de solução, correções de código e validação dentro de Visual Studio.

Scenarios

O agente fornece fluxos de trabalho de modernização de ponta a ponta chamados cenários. Cada cenário orienta você por meio de um tipo específico de tarefa de modernização.

Scenario Descrição Prompt de exemplo
Atualização do MSVC Build Tools (MSBuild) Atualiza projetos baseados em MSBuild (.sln, .vcxproj) para uma versão mais recente das Ferramentas de Build do MSVC e resolve problemas de build relacionados à atualização. "Atualizar meus projetos para usar a versão mais recente e instalada das Ferramentas de Build do MSVC"
Atualização das Ferramentas de Build do MSVC (CMake) Resolve problemas de build relacionados à atualização em seus projetos baseados em CMake depois de configurar o projeto com uma versão mais recente das Ferramentas de Build do MSVC. "Resolva os problemas de build causados pela atualização do meu projeto para usar as Ferramentas de Build do MSVC mais recentes"

Note

Se você quiser propor ou atualizar outros cenários de modernização, visite Developer Community.

Para obter uma referência completa de todos os cenários, consulte Cenários e referência de habilidades.

Pré-requisitos

Antes de começar, verifique se você tem estes itens:

  • Visual Studio 2026 versão 18.7 ou posterior.
  • Uma assinatura do GitHub Copilot.
  • Uma base de código baseada em MSBuild (.sln, .vcxproj) ou uma base de código baseada em CMake.

Para obter etapas detalhadas de instalação, consulte Instalar a modernização do GitHub Copilot para C++.

Como funciona

Para iniciar o fluxo de trabalho de modernização:

  1. Abra seu projeto ou solução do C++ em Visual Studio.
  2. Inicie o agente: em Gerenciador de Soluções, clique com o botão direito do mouse em sua solução ou projeto e selecione Modernize. Ou, em GitHub Copilot Chat, digite @Modernize.
  3. Diga ao agente o que atualizar.

Se estiver faltando na sua instalação do Visual Studio as MSVC Build Tools que seu projeto usa atualmente, o Assistente de Configuração deverá aparecer quando você carregar o projeto. Você pode usar o Assistente de Instalação para instalar a versão ausente do MSVC ou redirecionar para a versão do MSVC instalada. Se você redirecionar todos os projetos, receberá uma mensagem de barra de informações que pode iniciá-lo diretamente no fluxo de trabalho do agente Modernizar.

Quando você solicita ao agente para atualizar seu projeto, ele solicita que você crie um novo branch se você estiver em um repositório Git. Em seguida, ele executa um fluxo de trabalho de três estágios. Cada estágio produz arquivos Markdown dentro de .github/upgrades/{scenarioId} no seu repositório para que você possa examinar o que vem a seguir antes de continuar. Se .github/upgrades/{scenarioId} já existir de uma tentativa anterior, o agente perguntará se você deseja continuar ou iniciar novamente.

Estágio 1: Avaliação

O agente examina a estrutura do projeto, as dependências e os padrões de código e salva uma avaliação abrangente em assessment.md. O agente também apresenta decisões de estratégia para sua revisão, como estratégia de atualização e tratamento de compatibilidade.

Estágio 2: Planejamento

O agente converte a avaliação em uma especificação detalhada. O arquivo plan.md documenta estratégias de atualização, abordagens de refatoração e mitigações de risco.

Estágio 3: Execução

O agente divide o plano em tarefas sequenciais com critérios de validação em tasks.md. Cada tarefa descreve uma única alteração e como o agente confirma que ela foi bem-sucedida.

Modos de fluxo

O agente dá suporte a dois modos de fluxo:

  • Automático: funciona em todos os estágios sem pausar, parando apenas em bloqueadores genuínos. Esse modo é melhor para atualizações simples.
  • Guiado: Pausa no fim de cada etapa para você revisar. Esse modo é melhor para atualizações maiores ou mais complexas.

Você pode alternar os modos a qualquer momento modificando scenario-instructions.md ou instruindo o agente a alternar os modos. Se estiver em execução no modo Automatic, talvez seja necessário interromper o agente com o botão Cancelar na janela do prompt Copilot Chat e instruir o agente a retomar no modo Guided.

Gerenciamento de estado

O agente armazena todo o estado em .github/upgrades/{scenarioId}.

Arquivo Purpose
assessment.md Análise da solução.
plan.md Plano de tarefa ordenado.
tasks.md Painel de progresso ao vivo.
scenario-instructions.md Memória persistente do agente.
execution-log.md Registro de auditoria de todas as alterações.

Você pode fechar Visual Studio e retomar mais tarde. O agente continua de onde parou lendo os arquivos de estado.

Tip

Se você quiser trabalhar na sua atualização por um período mais longo enquanto realiza outras tarefas, considere fazer commit da pasta .github/upgrades na sua branch em commits separados. O estado comprometido serve como uma cópia de segurança e permite que os membros da equipe visualizem o progresso da atualização. Commits separados permitem removê-los facilmente do histórico local do Git antes de mesclar seu branch, caso você não queira que sejam registrados permanentemente no seu repositório.

Fornecer comentários

Microsoft valoriza seus comentários e o usa para melhorar o agente. Deixe comentários usando uma destas opções:

Conteúdo relacionado

  • Last updated on