Examen de las características de revisión de código de GitHub Copilot
GitHub Copilot puede revisar el código y proporcionar comentarios.
La revisión de código de GitHub Copilot en Visual Studio Code admite dos tipos de revisión:
- Selección de revisión: resalte el código y solicite una revisión inicial.
- Revisar los cambios: solicite una revisión más profunda de todos los cambios.
En la tabla siguiente se resume la funcionalidad actual y la disponibilidad de los dos tipos de revisión:
| Característica | Revisar la selección | Revisar cambios |
|---|---|---|
| Disponible en | Visual Studio Code | Visual Studio Code y el sitio web de GitHub |
| Característica Premium/estándar | Característica estándar disponible para todos los suscriptores de GitHub Copilot | Característica Premium. Disponible con los planes GitHub Copilot Pro, GitHub Copilot Pro+, GitHub Copilot Business y GitHub Copilot Enterprise. Se aplica la cuota mensual por persona. |
| Descripción | Revisión inicial de una sección resaltada del código con comentarios y sugerencias | Revisión más profunda de todos los cambios |
| Compatibilidad con lenguajes | Todos | C, C#, C++, Go, Java, JavaScript, Kotlin, Markdown, Python, Ruby, Swift, TypeScript. |
| Compatibilidad con directrices de codificación personalizadas | No | Sí |
Cuota mensual de revisión de código
El tipo de revisión de cambios en el código de GitHub Copilot es una función premium con una cuota mensual por persona. La cuota está activa actualmente.
Al asignar GitHub Copilot como revisor para una solicitud de incorporación de cambios, se deduce una solicitud premium de la cuota mensual cada vez que GitHub Copilot publica comentarios en la solicitud de incorporación de cambios.
Si un repositorio está configurado para solicitar automáticamente una revisión de código de GitHub Copilot para todas las nuevas solicitudes de incorporación de cambios, el uso de la solicitud Premium se aplica a la cuota del autor de la solicitud de incorporación de cambios. Si un pull request es creado por Acciones de GitHub o un bot, el uso se aplicará al usuario que desencadenó el flujo de trabajo (si es identificable) o a un propietario de facturación designado.
Cuando llegue a la cuota mensual, no podrá obtener una revisión de código de GitHub Copilot hasta que se restablezca la cuota, a menos que actualice el plan de GitHub Copilot o habilite más solicitudes premium.
Advertencia
GitHub Copilot no garantiza detectar todos los problemas en una solicitud de incorporación de cambios y, a veces, comete errores. Valide siempre los comentarios de GitHub Copilot cuidadosamente y complemente los comentarios de GitHub Copilot con una revisión humana.
Uso de las características de revisión de código
GitHub Copilot puede ayudar a revisar el código, ya sea para un bloque de código que seleccione en el editor o todos los cambios incluidos en una solicitud de incorporación de cambios (requiere la extensión GitHub solicitudes de incorporación de cambios).
Revisión de un bloque de código seleccionado en el editor de código
La acción revisar inteligente proporciona una manera de revisar y analizar el código. Puede ayudarle a identificar áreas para mejorar, sugerir actualizaciones de refactorización y proporcionar instrucciones sobre los procedimientos recomendados. Las sugerencias generadas por la característica de revisión de código pueden ayudarle a mejorar la calidad, confiabilidad, rendimiento y seguridad del código.
Abra un archivo de código en el editor.
Seleccione el código que desea revisar.
Haga clic con el botón derecho en el código seleccionado y seleccione Generar revisión de código>.
El agente de revisión de código crea comentarios de revisión en el panel COMENTARIOS (debajo del editor de código) y muestra las actualizaciones sugeridas insertadas en el editor de código.
Nota:
El menú contextual Visual Studio Code para GitHub Copilot se está actualizando activamente. La acción inteligente Revisar puede aparecer en el nivel superior del menú contextual (junto con Explicar) en lugar de en Generar código. Si la opción Revisar no está disponible en el menú contextual, puede realizar la misma acción seleccionando el código y escribiendo un mensaje como "revisar este código" directamente en la vista Chat.
Navegue por las sugerencias y aplique o descarte las actualizaciones.
Siempre que sea posible, los comentarios de Copilot incluyen cambios de código sugeridos. Use Aplicar y ir a siguiente para aceptar una sugerencia, o Descartar y ir a Siguiente para rechazarla. Los cambios aplicados no se confirman automáticamente.
Revisar todos los cambios en el código base
La característica GitHub Copilot Code Review proporciona una manera de revisar los cambios almacenados provisionalmente o no almacenados provisionalmente de su base de código. Puede ayudarle a identificar áreas para mejorar, sugerir actualizaciones de refactorización y proporcionar instrucciones sobre los procedimientos recomendados. Las sugerencias generadas por la característica de revisión de código pueden ayudarle a mejorar la calidad, confiabilidad, rendimiento y seguridad del código.
En Visual Studio Code, cambie a la vista Control de código fuente.
Para solicitar una revisión de los cambios sin etiquetar, mantenga el puntero del mouse sobre CHANGES y, a continuación, seleccione el botón GitHub Copilot Revisión de código: cambios no confirmados.
Espere a que GitHub Copilot revise los cambios. Esto suele tardar menos de 30 segundos.
Si GitHub Copilot tiene algún comentario, se mostrará en línea en sus archivos y en la pestaña Problemas.
Siempre que sea posible, los comentarios de Copilot incluyen cambios de código sugeridos. Use Aplicar y ir a siguiente para aceptar una sugerencia, o Descartar y ir a Siguiente para rechazarla. Los cambios aplicados no se confirman automáticamente.
Personalización de la revisión de código con directrices de codificación
Puede personalizar cómo Copilot revisa el código agregando instrucciones personalizadas al repositorio. Esto se admite para el tipo de revisión Revisar cambios.
Especifique instrucciones personalizadas para todo el repositorio en un .github/copilot-instructions.md archivo. Por ejemplo:
When performing a code review, focus on readability and avoid nested ternary operators.
When performing a code review, flag any use of hardcoded credentials.
También puede crear instrucciones específicas de ruta en archivos .github/instructions/**/*.instructions.md que Copilot usa únicamente para revisar archivos que coinciden con la ruta especificada.
Nota:
La revisión de código de Copilot solo lee los primeros 4,000 caracteres de cualquier archivo de instrucción personalizado. Las instrucciones que superan este límite no afectan a las revisiones generadas.
Resumen
GitHub Copilot puede revisar el código y proporcionar comentarios. La revisión de código de GitHub Copilot en Visual Studio Code admite dos tipos de revisión: revisar selección y revisar cambios. La acción revisar inteligente proporciona una manera de revisar y analizar el código seleccionado. Puede ayudarle a identificar áreas para mejorar, sugerir actualizaciones de refactorización y proporcionar instrucciones sobre los procedimientos recomendados. La característica Revisión de código de GitHub Copilot proporciona una manera de revisar los cambios preparados o sin preparar mediante la vista de Control de código fuente de Visual Studio Code.