Comentarios de revisión de código de GitHub Copilot faltantes: solución

Cuando esperas que GitHub Copilot sugiera mejoras durante una revisión de solicitud de extracción pero no ves comentarios en línea, el proceso de revisión se detiene. Esto sucede a menudo porque la función de revisión de código de Copilot requiere permisos específicos, un tipo de archivo compatible o un repositorio de GitHub configurado correctamente. La causa subyacente suele ser una asignación de licencia de GitHub Copilot faltante o caducada para el revisor, o una configuración del repositorio que bloquea a Copilot para escribir comentarios. Este artículo explica por qué no aparecen los comentarios de revisión de Copilot y proporciona los pasos exactos para restaurarlos.

Por qué no aparecen los comentarios de revisión de código de GitHub Copilot

GitHub Copilot puede generar comentarios de revisión de código solo cuando el revisor tiene una licencia válida de Copilot Enterprise o Copilot Business. La función no está disponible en los planes de Copilot Individual. Incluso con una licencia adecuada, el propietario de la organización debe habilitar la política de revisión de código en la configuración de Copilot. Si la política está desactivada, Copilot no publicará ningún comentario en las solicitudes de extracción. Además, las reglas de protección de rama que requieren un número específico de revisores o que bloquean comentarios de bots pueden impedir que Copilot escriba sus sugerencias. El revisor debe tener acceso de escritura o mantenimiento al repositorio para que Copilot pueda dejar comentarios. Si no se cumple alguna de estas condiciones, los comentarios de revisión faltarán.

Tipo de licencia y disponibilidad de funciones

Copilot Individual no incluye capacidades de revisión de código. Solo los planes Copilot Business y Copilot Enterprise admiten comentarios de revisión automatizados. El revisor debe tener un asiento asignado bajo uno de estos planes. Si el revisor tiene una licencia Business o Enterprise pero los comentarios aún faltan, el problema es probablemente una política o configuración de permisos.

Políticas de organización y repositorio

El propietario de la organización de GitHub debe habilitar la política de revisión de código en la sección de Copilot de la configuración de la organización. Esta política controla si Copilot puede publicar comentarios en las solicitudes de extracción en todos los repositorios de la organización. Si la política está deshabilitada, no aparecerán comentarios de revisión de Copilot. Incluso cuando está habilitada, la configuración individual del repositorio puede anular la política de la organización si las reglas de protección de rama bloquean comentarios de usuarios automatizados.

Pasos para solucionar los comentarios de revisión de código de GitHub Copilot faltantes

Sigue estos pasos en orden. Prueba después de cada paso abriendo una nueva solicitud de extracción o actualizando una existente para ver si aparecen comentarios.

1. Verifica la asignación de licencia de Copilot para el revisor
   Inicia sesión en GitHub como propietario de la organización. Ve a Configuración > Organización > Copilot. En Gestión de asientos, confirma que la cuenta del revisor esté listada con un plan Business o Enterprise. Si el revisor no está asignado, haz clic en Agregar asientos e ingresa el nombre de usuario. Guarda el cambio. El revisor debe cerrar sesión y volver a iniciarla para activar la licencia.
2. Habilita la política de revisión de código a nivel de organización
   En la misma página de configuración de Copilot, encuentra la sección Políticas. Localiza Revisión de código y establécelo en Habilitado. Haz clic en Guardar. Esto permite que Copilot publique comentarios en las solicitudes de extracción en todos los repositorios. Si deseas restringirlo a repositorios específicos, usa la lista de permitidos de repositorios debajo del interruptor de política.
3. Revisa las reglas de protección de rama del repositorio
   Ve al repositorio donde está abierta la solicitud de extracción. Navega a Configuración > Ramas > Reglas de protección de rama. Edita la regla para la rama objetivo. En Reglas aplicadas a todos, incluidos administradores, asegúrate de que Requerir revisiones de solicitudes de extracción antes de fusionar no esté establecido en un número mayor que cero si deseas que los comentarios de Copilot cuenten. Además, desmarca Descartar aprobaciones de solicitudes de extracción obsoletas cuando se envíen nuevas confirmaciones si deseas que los comentarios de Copilot persistan después de las actualizaciones. Guarda la regla.
4. Confirma que el revisor tenga acceso de escritura al repositorio
   En el repositorio, ve a Configuración > Colaboradores y equipos. Verifica que la cuenta del revisor tenga el rol de Escritura o Mantenimiento. Si el rol es Lectura, Copilot no puede publicar comentarios. Cambia el rol a Escritura y guarda.
5. Crea una nueva solicitud de extracción para activar la revisión
   Abre una nueva solicitud de extracción con al menos un cambio de archivo. Copilot solo revisa solicitudes de extracción que modifican archivos de código. Después de abrir la solicitud de extracción, espera hasta 30 segundos para que Copilot genere comentarios. Actualiza la página si los comentarios no aparecen. Si los comentarios aún no se muestran, repite los pasos 1 a 4 para asegurarte de que no se haya omitido ninguna configuración.

Si Copilot aún tiene problemas después de la solución principal

Algunos problemas requieren solución de problemas adicional más allá de la configuración principal.

Los comentarios de revisión de Copilot aparecen solo en algunas solicitudes de extracción

Copilot no revisa solicitudes de extracción que contienen solo archivos que no son de código, como imágenes, PDFs o archivos de texto plano. También omite solicitudes de extracción con más de 500 líneas de cambios. Para probar, crea una solicitud de extracción pequeña que modifique un solo archivo de código. Si los comentarios aparecen en esa solicitud de extracción pero no en otras, la causa es el tipo de archivo o el límite de tamaño.

Los comentarios de Copilot son rechazados por revisores requeridos

Si tu repositorio utiliza revisores requeridos, los comentarios de Copilot pueden ser descartados u ocultados. Para solucionarlo, ve a Configuración del repositorio > Ramas > Reglas de protección de rama. Edita la regla y desmarca Requerir revisión de los propietarios del código. Alternativamente, agrega al usuario de Copilot como propietario del código en el archivo CODEOWNERS. Esto da a los comentarios de Copilot el mismo peso que los comentarios de los revisores humanos.

Los comentarios de revisión de Copilot no aparecen en la pestaña Conversación

Copilot publica sus comentarios en la pestaña Archivos modificados de la solicitud de extracción. Revisa esa pestaña específicamente. Si los comentarios están allí pero no son visibles en la pestaña Conversación, esto es un comportamiento normal. Copilot no publica comentarios resumidos en el hilo principal de conversación. Puedes ver todas las sugerencias de Copilot solo en la vista de diferencias.

Elemento	Copilot Business	Copilot Enterprise
Comentarios de revisión de código	Sí	Sí
Instrucciones de revisión personalizadas	No	Sí
Bases de conocimiento para revisión	No	Sí
Costo de licencia por usuario al mes	$19	$39

Si los comentarios de revisión de Copilot aún faltan después de todos estos pasos, abre un ticket de soporte con GitHub. Incluye la URL de la solicitud de extracción y una captura de pantalla de la página de configuración de Copilot. El equipo de soporte puede revisar los registros del lado del servidor para encontrar solicitudes bloqueadas.

Ahora puedes restaurar los comentarios de revisión de código de Copilot faltantes verificando la licencia, habilitando la política de la organización y ajustando las reglas de protección de rama. Después de aplicar estos cambios, prueba con una solicitud de extracción pequeña para confirmar que la solución funciona. Para una fiabilidad continua, revisa periódicamente las asignaciones de asientos de Copilot en la configuración de tu organización para asegurarte de que ningún asiento caduque. Como paso avanzado, considera usar Copilot Enterprise con instrucciones de revisión personalizadas para adaptar los comentarios a los estándares de codificación de tu equipo.