Nota:
GitHub Code Quality está actualmente en versión preliminar pública y sujeto a cambios. Durante versión preliminar pública, Code Quality no se facturará, aunque los escaneos de Code Quality consumirán minutos de GitHub Actions.
Comprender por qué está bloqueado el pull request
Los administradores del repositorio pueden establecer puertas de calidad de código para mantener el mantenimiento y la confiabilidad mediante GitHub Code Quality. Al abrir un pull request, se ejecuta automáticamente un examen para verificar que sus cambios cumplan con estos estándares.
Si la solicitud de incorporación de cambios introduce código que está por debajo del umbral de calidad necesario, verá un banner de bloque de combinación en la parte inferior de la solicitud de incorporación de cambios en la sección Comprobaciones: "La combinación está bloqueada: se detectaron resultados de calidad del código".
Estas comprobaciones ayudan a mantener un código base saludable y fácil de mantener y evitar que la deuda técnica se acumula.
Visualización de los resultados del examen y sus niveles de gravedad
Los resultados del análisis se notifican como comentarios en su solicitud de incorporación de cambios, que deja github-code-quality[bot]. Cada comentario corresponde a un problema de calidad de código específico que se detectó en los cambios.
Los comentarios se etiquetan por gravedad (Error, Advertencia, Nota). Para más información sobre lo que significan los niveles de gravedad, consulte Niveles de gravedad.
Determinar qué hallazgos bloquean la solicitud de incorporación de cambios
La puerta de calidad establecida por los administradores del repositorio define el nivel de gravedad mínimo que bloqueará la combinación.
El banner del bloque de mezcla puede especificar el nivel de gravedad mínimo. Todos los resultados en ese nivel de gravedad o superior deben abordarse antes de poder fusionar la solicitud de incorporación de cambios.
Nota:
Si no ve un nivel de gravedad definido en el banner del bloque de fusión, significa que el repositorio usa los umbrales de calidad de código más estrictos, lo que requiere que se solucionen todos los hallazgos antes de proceder con la fusión.
Corregir o descartar cada hallazgo
Para desbloquear la solicitud de incorporación de cambios, usted debe resolver cada observación requerida al decidir si corregir el problema en su código o descartar el comentario.
Aprovechamiento de Autofix de Copilot y agente en la nube de Copilot para corregir hallazgos
Autofix de Copilot
Los comentarios de la solicitud de incorporación de cambios incluyen un autofix sugerido que puede confirmar directamente en su solicitud. Revise cuidadosamente la corrección automática sugerida en cuanto a lógica, seguridad y estilo, luego haga clic en Confirmar sugerencia.
No necesita una licencia Copilot para aplicar estas sugerencias.
agente en la nube de Copilot
Como alternativa, si tiene una Copilot licencia, puede delegar el trabajo de corrección en agente en la nube de Copilot. Haga un comentario en la solicitud de incorporación de cambios mencionando @Copilot y solicite que Copilot corrija los problemas detectados.
Copilot responde con un emoji de ojos (👀) a tu comentario, inicia una nueva sesión del agente y abre un pull request con las correcciones necesarias.
Puede hacer seguimiento del trabajo de agente en la nube de Copilot.
- En el pull request, el resumen se actualiza conforme avanza el trabajo.
- Utilizando la página de agentes o los registros de sesión: consulte Seguimiento de las sesiones de GitHub Copilot.
Necesita una Copilot licencia para invocar agente en la nube de Copilot.
Regístrese para Copilot
Descartar el hallazgo
Puede descartar una búsqueda si no es relevante o procesable en el contexto de su código base. Entre las razones comunes para descartar un hallazgo se incluyen:
- El hallazgo está en el código heredado que ya no se mantiene.
- Es una excepción conocida a los estándares de codificación de su equipo.
- Es un falso positivo que no supone un riesgo real de calidad.
Descartar alertas irrelevantes mantiene las comprobaciones de calidad centradas en problemas significativos.
Comprobación de que ha cumplido los requisitos
Para ver si ha cumplido los requisitos de calidad del código, consulte la sección "Comprobaciones" en la parte inferior de la solicitud de incorporación de cambios. El banner del bloque de combinación ya no debería estar presente, y debería poder fusionar sus cambios como siempre.
Pasos siguientes
Reduzca la deuda técnica mediante la corrección de los hallazgos en archivos modificados recientemente. Consulta Mejora de la calidad de código combinado recientemente con IA.