¿Qué es la modernización de GitHub Copilot?

La modernización con GitHub Copilot es un agente de GitHub Copilot que te ayuda a actualizar y modernizar tus proyectos de C++. Le guía a través de la evaluación, las recomendaciones de soluciones, las correcciones de código y la validación dentro de Visual Studio.

Escenarios

El agente proporciona flujos de trabajo de modernización de un extremo a otro denominados escenarios. Cada escenario le guía a través de un tipo específico de tarea de modernización.

Escenario Descripción Mensaje de ejemplo
Actualización de herramientas de compilación de MSVC (MSBuild) Actualiza los proyectos basados en MSBuild (.sln, .vcxproj) a una versión más reciente de las herramientas de compilación de MSVC y resuelve los problemas de compilación relacionados con la actualización. "Actualizar mis proyectos para usar la versión más reciente instalada de las herramientas de compilación de MSVC"
Actualización de herramientas de compilación de MSVC (CMake) Resuelve los problemas de compilación relacionados con la actualización en los proyectos basados en CMake después de configurar el proyecto con una versión más reciente de MSVC Build Tools. "Resuelva los problemas de compilación causados por la actualización de mi proyecto para usar las herramientas de compilación de MSVC más recientes"

Note

Si desea proponer o invocar otros escenarios de modernización, visite Developer Community.

Para obtener una referencia completa de todos los escenarios, consulte Escenarios y referencia de aptitudes.

Prerequisites

Antes de empezar, asegúrese de que dispone de lo siguiente:

  • Visual Studio 2026, versión 18.7 o posterior.
  • Una suscripción de GitHub Copilot.
  • Un código base basado en MSBuild (.sln, .vcxproj) o un código base basado en CMake.

Para consultar los pasos detallados de configuración, vea Instalar la modernización de GitHub Copilot para C++.

Cómo funciona

Para iniciar el flujo de trabajo de modernización:

  1. Abra el proyecto o la solución de C++ en Visual Studio.
  2. Inicie el agente: en Explorador de soluciones, haga clic con el botón derecho en la solución o proyecto y seleccione Modernize. O bien, en GitHub Copilot Chat, escriba @Modernize.
  3. Indique al agente qué actualizar.

Si a tu instalación de Visual Studio le faltan las herramientas de compilación de MSVC que tu proyecto usa actualmente, el Asistente de instalación debería aparecer cuando cargues tu proyecto. Puede utilizar el Asistente de instalación ya sea para instalar la versión de MSVC que falta o para cambiar el destino a la versión instalada de MSVC. Si cambia la plataforma de destino de algún proyecto, recibirá un mensaje en la barra de información desde el que podrá iniciar directamente el flujo de trabajo del agente Modernize.

Cuando le pides al agente que actualice tu proyecto, te pedirá que crees una nueva rama si estás en un repositorio Git. A continuación, ejecuta un flujo de trabajo de tres fases. Cada fase genera archivos Markdown en .github/upgrades/{scenarioId} en el repositorio para que pueda revisar lo que viene a continuación antes de continuar. Si .github/upgrades/{scenarioId} ya existe a partir de un intento anterior, el agente pregunta si desea continuar o comenzar de nuevo.

Fase 1: Evaluación

El agente examina la estructura, las dependencias y los patrones de código del proyecto y guarda una evaluación completa en assessment.md. El agente también presenta decisiones de estrategia para su revisión, como la estrategia de actualización y el control de compatibilidad.

Fase 2: Planificación

El agente convierte la evaluación en una especificación detallada. El archivo plan.md documenta estrategias de actualización, enfoques de refactorización y mitigaciones de riesgos.

Fase 3: Ejecución

El agente divide el plan en tareas secuenciales con criterios de validación en tasks.md. Cada tarea describe un único cambio y cómo el agente confirma que se realizó correctamente.

Modos de flujo

El agente admite dos modos de flujo:

  • Automático: funciona en todas las etapas sin pausas, deteniéndose solo ante bloqueos reales. Este modo es mejor para actualizaciones sencillas.
  • Guiado: pausa en cada límite de fase para su revisión. Este modo es mejor para actualizaciones más grandes o más complejas.

Puede cambiar los modos en cualquier momento modificando scenario-instructions.md o instruyendo al agente para cambiar los modos. Si se está ejecutando en modo Automático, es posible que tenga que detener el agente con el botón Cancelar en la ventana de solicitud de Copilot Chat e indicarle al agente que reanude la ejecución en modo Guiado.

Administración de estados

El agente almacena todo el estado en .github/upgrades/{scenarioId}.

Archivo propósito
assessment.md Análisis de la solución.
plan.md Plan de tareas ordenado.
tasks.md Panel de progreso activo.
scenario-instructions.md Memoria persistente del agente.
execution-log.md Registro de auditoría de todos los cambios.

Puede cerrar Visual Studio y reanudarlo más adelante. El agente retoma la tarea donde la dejó al leer los archivos de estado.

Tip

Si quiere trabajar en la actualización durante un período de tiempo más largo mientras realiza otras tareas, considere hacer commits separados de la carpeta .github/upgrades en su rama. El estado comprometido actúa como respaldo y permite a los miembros del equipo ver el progreso de la actualización. Los commits separados te permiten eliminarlos fácilmente del historial local de Git antes de fusionar tu rama si no quieres que queden registrados permanentemente en tu repositorio.

Proporcionar comentarios

Microsoft valora sus comentarios y los utiliza para mejorar su agente. Deje comentarios con cualquiera de estas opciones:

Contenido relacionado

  • Last updated on