Usa la revisión de código de GitHub Copilot a lo largo del ciclo de vida de la solicitud de incorporación de cambios

Introduction

revisión de código Copilot es más eficaz cuando lo usas como parte de un flujo de trabajo de pull requests. Este tutorial muestra cómo elegir entre revisiones manuales y automáticas, solicitar revisiones desde el principio en las solicitudes de incorporación de cambios en borrador y decidir cuándo solicitar una nueva revisión antes de la fusión.

También aprenderás cuándo usar la personalización, las habilidades, los servidores MCP y las opciones del ejecutor para adaptar las revisiones de Copilot a tus necesidades.

Trabajar a través del ciclo de vida de la solicitud de incorporación de cambios

Elija un modelo de revisión y configure los comentarios anticipados para las solicitudes de incorporación de cambios activas y borradores.

Elección del modelo de revisión adecuado para el equipo

revisión de código Copilot puede ejecutarse manualmente, al desencadenarlo usted mismo o automáticamente, en uno o varios puntos del ciclo de vida de una solicitud de incorporación de cambios. Las revisiones manuales te permiten controlar exactamente cuándo interviene revisión de código Copilot. Las revisiones automáticas garantizan una cobertura consistente y permiten elegir si se ejecutan al abrirse, en borrador o con cada nuevo push.

Revisar modelo	Más adecuado para	Por qué
Solicitud de revisión manual	Cambios de alto contexto o uso selectivo	Puedes activar Copilot solo cuando quieras una perspectiva diferente.
Revisión automática de las solicitudes de extracción abiertas	Equipos que desean una cobertura amplia y coherente	Cada solicitud de incorporación de cambios obtiene comentarios de línea base sin depender de hábitos individuales.
Revisión automática de las solicitudes de extracción en borrador	Equipos que quieren ciclos de retroalimentación más tempranos	Los autores pueden corregir problemas antes de que se inicie la revisión humana.
Revisión automática en nuevas inserciones	Solicitudes de incorporación de cambios rápidas con varias revisiones
Copilot vuelve a evaluar las actualizaciones sustanciales a medida que evoluciona la solicitud de incorporación de cambios.

Para conocer los pasos de configuración, consulte Uso de GitHub Copilot para la revisión de código y Configuración de la revisión automática de código mediante GitHub Copilot.

Usa revisión de código Copilot desde el principio en las solicitudes de extracción en borrador

La revisión del borrador de solicitudes de incorporación de cambios con revisión de código Copilot le ofrece una comprobación confiable y temprana del código antes de solicitar una revisión del equipo.

Un flujo de trabajo en borrador útil es:

1. Abra una solicitud de incorporación de cambios como borrador.
2. Solicita una revisión de revisión de código Copilot en Revisores o habilita la revisión automática para las solicitudes de extracción en borrador.
3. Solucione primero los comentarios de alta confianza, como la corrección, la seguridad y los problemas de mantenimiento claros.
4. Inserte actualizaciones y confirme que se han resuelto los comentarios principales.
5. Marque la solicitud de incorporación de cambios como lista para la revisión humana.

Este enfoque ayuda a su equipo a dedicar más tiempo de revisión humana a los inconvenientes de diseño y al impacto en el producto, en lugar de problemas obvios que podrían haberse detectado anteriormente.

Ajustar la calidad de las revisiones

Mejore la calidad de la revisión al decidir cuándo solicitar una nueva revisión y dónde agregan valor la personalización, el contexto externo y los ejecutores.

Usa una segunda revisión antes de la fusión

Después de cambios sustanciales, solicite volver a revisar para comprobar si se introdujeron nuevos riesgos al abordar los comentarios anteriores.

Solicite que vuelva a revisarlo cuando:

• Actualice varios archivos a través de los límites del servicio o del paquete.
• Cambiar un comportamiento delicado para la seguridad o los datos.
• Aplicar un gran lote de cambios sugeridos y querer una revisión final.

Para los equipos con actualizaciones frecuentes en las solicitudes de extracción activas, habilitar las revisiones automáticas con nuevos pushs puede reducir las solicitudes manuales de nueva revisión, al tiempo que mantiene los comentarios actualizados.

Adapte la personalización a su flujo de trabajo

La personalización es más útil cuando cada tipo de archivo admite un punto de decisión de revisión en el flujo de trabajo:

• Utilice .github/copilot-instructions.md para las expectativas de revisión de todo el repositorio que deberían aplicarse a la mayoría de las solicitudes de extracción.
• Utiliza .github/instructions/**/*.instructions.md para orientaciones específicas para el agente y para la ruta cuando distintas partes de la base de código tienen estándares diferentes.
• Use AGENTS.md para proporcionar contexto de repositorio que mejore la relevancia, como patrones intencionales, límites de arquitectura o prioridades de revisión.

Mantenga estos archivos enfocados en lo que los revisores necesitan decidir durante las pull requests. Evite convertirlos en manuales de ingeniería completos.

Para obtener ejemplos y mecanismos de personalización detallados, consulte Uso de instrucciones personalizadas para desbloquear la eficacia de la revisión de código de Copilot.

Uso de aptitudes de agente y servidores MCP para objetivos de revisión especializados

Las aptitudes del agente y los servidores MCP son más valiosas cuando el equipo necesita revisiones que dependen del contexto específico de la organización.

Use las aptitudes del agente cuando desee rutinas de revisión reutilizables, por ejemplo:

• Aplicar una lista de verificación estándar a las pull requests de migración.
• Ejecutar pasadas de revisión específicas del lenguaje o del framework en un monorepo.
• Priorizar determinadas áreas de riesgo, como la lógica de autorización o facturación.

Use servidores MCP cuando las revisiones deben hacer referencia al contexto fuera de la propia solicitud de incorporación de cambios, por ejemplo:

• Vincular los cambios de la solicitud de extracción con los datos de incidencia, incidente o titularidad del servicio.
• Comprobación del despliegue previsto o del contexto operativo a partir de sistemas internos.
• Validar los detalles de implementación en orígenes de documentación externos.

Para obtener más información sobre la configuración, consulte Agregar aptitudes de agente para GitHub Copilot y Configuración de servidores MCP para el repositorio.

Decidir si necesita ejecutores autohospedados

En muchos casos, los ejecutores estándar alojados en GitHub son suficientes para revisión de código Copilot y no requieren configuración; vienen configurados de forma predeterminada.

Considere los runners autohospedados o de mayor tamaño cuando necesite:

• Mejor rendimiento para cargas de trabajo de revisión más pesadas.
• Acceso de red a los sistemas internos requeridos por su organización.

Los runners son necesarios porque revisión de código Copilot usa GitHub Actions para operaciones agénticas, como la recopilación de contexto más detallado y la invocación de herramientas. Si los ejecutores alojados en GitHub no están disponibles y no hay ninguna opción autoalojada compatible configurada correctamente, las revisiones pasarán a un modo más limitado.

Para obtener detalles de planeación y configuración, consulte Configuración de ejecutores para la revisión de código de GitHub Copilot.

Flujos de trabajo recomendados por escenario

Escenario de equipo	Flujo de trabajo recomendado
Equipo pequeño con pull requests frecuentes	Habilitar revisiones automáticas para todas las solicitudes de extracción, revisar los borradores para obtener comentarios tempranos y usar una nueva revisión manual antes de la fusión cuando los cambios sean sustanciales.
Monorepo grande con pilas mixtas	Activar las revisiones automáticas y revisar los nuevos cambios enviados, añadir instrucciones específicas para cada ruta en cada área principal y usar habilidades para patrones de revisión repetidos.
Código base regulado o sensible a la seguridad	Usar las revisiones de solicitudes de extracción en borrador junto con una nueva revisión obligatoria antes de la fusión, mantener las directrices de seguridad de todo el repositorio en .github/copilot-instructions.md y usar servidores MCP para el contexto de incidentes o de cumplimiento almacenado fuera de GitHub.
Equipo con dependencias internas de la plataforma	Comience con la revisión automática y agregue ejecutores autohospedados y contexto MCP solo cuando se requiera acceso interno al sistema para obtener comentarios útiles de revisión.

Pasos siguientes

• Para obtener más información sobre conceptos más generales, incluido el esfuerzo de revisión y las capacidades agénticas, consulte Sobre la revisión de código de GitHub Copilot.
• Para ajustar la calidad de revisión automatizada para repositorios específicos, consulte Creación de un proceso de revisión optimizado con Copilot.
• Para ver los tipos de archivo excluidos y otros límites, consulte Archivos excluidos de revisión de código GitHub Copilot.