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 durante todo el ciclo de vida de la solicitud de incorporación de cambios

Elija un modelo de revisión y configure comentarios iniciales para las solicitudes de incorporación de cambios en borrador y activas.

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

revisión de código Copilot puede ejecutarse manualmente, al activarlo manualmente o automáticamente en uno o más 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 recibe comentarios de referencia sin depender de los hábitos individuales.
Revisión automática en solicitudes de incorporación de cambios 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 revisiones múltiples	Copilot reevalúa 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.

Use revisión de código Copilot desde el principio en solicitudes de incorporación de cambios en borrador

La revisión de solicitudes de incorporación de cambios en borrador con revisión de código Copilot le ofrece una verificación temprana y fiable de su código antes de que solicitar una revisión a su equipo.

Un flujo de trabajo en borrador útil es:

1. Abra una solicitud de incorporación de cambios como borrador.
2. Solicite una revisión a revisión de código Copilot en Revisores o habilite la revisión automática para las solicitudes de incorporación de cambios en borrador.
3. Solucione primero los comentarios de alta confianza, tales como la exactitud, la seguridad y los problemas claros de mantenibilidad.
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.
• Aplique un lote grande de cambios sugeridos y solicite una revisión final.

Para equipos con actualizaciones frecuentes en las solicitudes de incorporación de cambios activas, habilitar las revisiones automáticas en nuevas inserciones puede reducir las solicitudes de revisión manuales a la vez que se mantienen 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 revisiones específicas de lenguaje o marco de trabajo en un monorepositorio.
• 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 cambios en las solicitudes de incorporación de cambios con datos de problemas, incidentes o propiedad 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.

Decida 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 el uso de ejecutores autohospedados o de mayor tamaño cuando lo 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 ejecutores son necesarios porque revisión de código Copilot utiliza GitHub Actions para operaciones de agente, tales como la recopilación de contexto más profundo y la llamada a herramientas. Si los ejecutores hospedados en GitHub no están disponibles y no hay ninguna opción autohospedada compatible configurada correctamente, las revisiones volverá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.
Monorepositorio grande con pilas tecnológicas mixtas.	Habilite las revisiones automáticas y revise las nuevas inserciones; añada instrucciones específicas de ruta para cada área principal y utilice habilidades para patrones de revisión repetidos.
Código base regulado o sensible a la seguridad	Utilice revisiones de solicitudes de incorporación de cambios en borrador junto con una revisión obligatoria antes de la fusión, mantenga las expectativas de seguridad a nivel de repositorio en .github/copilot-instructions.md y use servidores MCP para el contexto de incidentes o 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.