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

O GitHub Copilot Modernization é um agente do GitHub Copilot que ajuda-o a atualizar e modernizar projetos em C++. Orienta-te através de avaliações, recomendações de soluções, correções de código e validação dentro do Visual Studio.

Scenarios

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

Scenario Description Exemplo de prompt
Atualização do MSVC Build Tools (MSBuild) Atualiza projetos baseados no MSBuild (.sln, .vcxproj) para uma versão mais recente do MSVC Build Tools e resolve problemas de compilação relacionados com atualizações. "Atualizar os meus projetos para usar a versão mais recente e instalada das Ferramentas de Build MSVC"
Atualização do MSVC Build Tools (CMake) Resolve problemas de compilação relacionados com atualizações nos seus projetos baseados em CMake após configurar o projeto com uma versão mais recente das Ferramentas de Construção MSVC. "Resolver quaisquer problemas de compilação causados pela atualização do meu projeto para usar as mais recentes Ferramentas de Compilação MSVC"

Observação

Se quiser propor ou votar noutros cenários de modernização, visite Developer Community.

Para uma referência completa de todos os cenários, veja Referência de cenários e habilidades.

Pré-requisitos

Antes de começar, certifique-se de que:

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

Para obter instruções detalhadas de configuração, consulte Instalar a modernização do GitHub Copilot para C++.

Como funciona

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

  1. Abra o seu projeto ou solução C++ no Visual Studio.
  2. Iniciar o agente: Em Explorador de Soluções, clique com o botão direito na sua solução ou projeto e selecione Modernizar. Ou, em GitHub Copilot Chat, escreva @Modernize.
  3. Diz ao agente o que deve melhorar.

Se a sua instalação do Visual Studio não tiver as Ferramentas de Compilação MSVC que o seu projeto utiliza, o Assistente de Configuração deverá aparecer quando carrega o projeto. Pode usar o Assistente de Configuração para instalar a versão MSVC em falta ou para redirecionar para a versão MSVC instalada. Se redirecionares algum projeto, vais receber uma mensagem infobar que te pode lançar diretamente no fluxo de trabalho do agente Modernize.

Quando pedes ao agente para atualizar o teu projeto, ele pede-te para criar um novo branch se estiveres num repositório Git. Depois executa um fluxo de trabalho em três etapas. Cada fase produz ficheiros Markdown no .github/upgrades/{scenarioId} teu repositório para que possas rever o que vem a seguir antes de continuares. Se .github/upgrades/{scenarioId} já existir na sequência de uma tentativa anterior, o agente pergunta se quer continuar ou recomeçar do zero.

Fase 1: Avaliação

O agente examina a estrutura do seu projeto, dependências e padrões de código e guarda uma avaliação abrangente para assessment.md. O agente também apresenta decisões estratégicas para a sua análise, como estratégia de atualização e gestão de compatibilidade.

Fase 2: Planeamento

O agente converte a avaliação numa especificação detalhada. O ficheiro plan.md documenta estratégias de atualização, abordagens de refatoração e medidas de mitigação de riscos.

Fase 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 foi bem-sucedida.

Modos de fluxo

O agente suporta dois modos de fluxo:

  • Automático: Funciona em todas as fases sem parar, parando apenas em bloqueadores genuínos. Este modo é melhor para melhorias diretas.
  • Guiado: Pausas em cada limite de estágio para a sua revisão. Este modo é melhor para melhorias maiores ou mais complexas.

Pode mudar de modo a qualquer momento, modificando scenario-instructions.md ou instruindo o agente a mudar de modo. Se estiver a correr em modo Automático, pode ter de parar o agente com o botão Cancelar na janela de Copilot Chat e instruir o agente a retomar em modo Guiado.

Gestão do Estado

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

Ficheiro Purpose
assessment.md Análise da sua solução.
plan.md Plano de tarefas ordenado.
tasks.md Painel de progresso em tempo real.
scenario-instructions.md Memória persistente do agente.
execution-log.md Registo de auditoria de todas as alterações.

Podes fechar o Visual Studio e retomar mais tarde. O agente retoma a partir do ponto em que parou ao ler os ficheiros de estado.

Sugestão

Se quiseres trabalhar na atualização ao longo de mais tempo enquanto fazes outras tarefas, considera registar a pasta .github/upgrades na tua ramificação em commits distintos. O estado comprometido serve como backup e permite aos membros da equipa ver o progresso da atualização. Commits separados permitem-te removê-los facilmente do histórico local do Git antes de fazer merge do teu ramo, caso não queiras que fiquem permanentemente registados no teu repositório.

Fornecer comentários

A Microsoft valoriza o teu feedback e usa-o para melhorar o agente. Deixe feedback usando qualquer uma destas opções:

Conteúdo relacionado

  • Last updated on