Note
- La GitHub Copilot code review se encuentra en versión preliminar pública y está sujeta a cambios. Algunas funciones están disponibles para todos los suscriptores de Copilot, pero otras solo lo están para un número limitado de usuarios. Para unirte a la lista de espera, consulta "Unirse a la lista de espera de la Copilot code review".
- Los "Términos de licencia de la versión preliminar de GitHub" se aplican a tu uso de este producto.
Acerca de la Copilot code review
GitHub Copilot puede revisar el código y proporcionar comentarios. Siempre que es posible, los comentarios de Copilot incluyen cambios sugeridos que puedes aplicar con un par de clics.
La Copilot code review admite dos tipos de revisión:
- Revisión de la selección: resalta la parte del código que quieras y pide una revisión inicial (solo Visual Studio Code)
- Revisión de los cambios: solicita una revisión más minuciosa de todos los cambios (sitio web de GitHub y Visual Studio Code)
En la tabla siguiente se resumen la funcionalidad y la disponibilidad actuales de los dos tipos de revisión:
| Característica | Revisión de la selección | Revisión de los cambios |
|---|---|---|
| Descripción | Revisión inicial de una sección resaltada del código con comentarios y sugerencias | Revisión más minuciosa de todos los cambios |
| Compatibilidad con idiomas | All | C#, Go, Java, JavaScript, Markdown, Python, Ruby, TypeScript |
| Compatibilidad con instrucciones de codificación personalizadas | No | Sí, consulta Personalización de las revisiones de Copilot con instrucciones de código |
| Entorno | Visual Studio Code | Visual Studio Code y el sitio web de GitHub |
| Disponibilidad | versión preliminar pública, disponible para todos los suscriptores de Copilot | versión preliminar pública con lista de espera, consulta "Unirse a la lista de espera de la Copilot code review" |
Warning
No se garantiza que Copilot detecte todos los problemas o incidencias de una solicitud de cambios y, en ocasiones, cometerá errores. Valida siempre los comentarios de Copilot de forma minuciosa y complétalos con una revisión humana.
Para obtener más información, vea «Uso responsable de la revisión de código de GitHub Copilot».
Solicitud de una revisión de Copilot
Estas instrucciones explican cómo usar la Copilot code review en el sitio web de GitHub. Para ver las instrucciones de Visual Studio Code, usa el conmutador de herramientas "Visual Studio Code"en la parte superior de la página.
Solicitud de una revisión de solicitud de cambios de Copilot
Note
La opción de solicitar una revisión de solicitud de cambios de Copilot solo está disponible actualmente para un número limitado de suscriptores de Copilot. Para unirte a la lista de espera, consulta "Unirse a la lista de espera de la Copilot code review".
-
En GitHub.com, cree una solicitud de incorporación de cambios o vaya a una solicitud de incorporación de cambios existente.
-
Abre el menú Reviewers y, a continuación, selecciona Copilot.
-
Espera a que Copilot revise tu solicitud de cambios. Esto suele tardar menos de 30 segundos.
-
Desplázate hacia abajo y lee los comentarios de Copilot.
Copilot siempre deja una revisión "Comment", no "Approve" ni "Request changes". Esto significa que las revisiones de Copilot no se tienen en cuenta como revisiones requeridas de las solicitudes de cambios y las revisiones de Copilot no bloquearán la fusión de cambios. Para más detalles, consulta "Aprobar una solicitud de extracción con revisiones requeridas".
-
Los comentarios de revisión de Copilot se comportan como los que realizan los humanos. Puedes agregar reacciones a ellos, comentarlos, resolverlos y ocultarlos.
Los usuarios podrán ver cualquier comentario que agregues a los comentarios de revisión de Copilot, pero no serán visibles para Copilot, que no responderá.
Cómo trabajar con los cambios sugeridos que proporciona Copilot
Siempre que es posible, los comentarios de Copilot incluyen cambios sugeridos que puedes aplicar con un par de clics.
Si estás de acuerdo con los cambios, puedes aceptar una única sugerencia de Copilot y confirmarla, o bien aceptar un grupo de sugerencias de forma conjunta en una sola confirmación. Para obtener más información, vea «Incorporar comentarios en tu solicitud de extracción».
Si quieres validar los cambios sugeridos por Copilot (por ejemplo, mediante la ejecución de pruebas automatizadas o el linter) o quieres realizar modificaciones antes de confirmar los cambios sugeridos, haz clic en el botón Open in Workspace. Para obtener más información, vea «Using Copilot to help you work on a pull request».
Comentarios sobre las revisiones de Copilot
Puedes responder a los comentarios de Copilot directamente dentro de cada comentario. Usamos esta información para mejorar el producto y la calidad de las sugerencias de Copilot.
-
En un comentario de revisión de solicitud de cambios de Copilot, haz clic en el botón de pulgar hacia arriba (👍) o hacia abajo (👎).
-
Si haces clic en el botón de pulgar hacia abajo, se te pedirá que proporciones información adicional. También tienes la opción de elegir el motivo de tus comentarios negativos y dejar un comentario antes de hacer clic en Submit feedback.
Solicitud de nueva revisión de Copilot
Al insertar cambios en una solicitud de cambios que Copilot ha revisado, este no volverá a revisar tus cambios de forma automática.
Para solicitar una nueva revisión de Copilot, haz clic en el botón situado junto al nombre de Copilot en el menú Reviewers. Para obtener más información, vea «Solicitar una revisión de solicitud de extracción».
Note
Al revisar de nuevo una solicitud de cambios, puede que Copilot vuelva a repetir los mismos comentarios, incluso aunque se hayan descartado con el botón "Resolve conversation" o se haya votado en contra con el botón de pulgar hacia abajo (👎).
Cómo habilitar las revisiones automáticas de Copilot
De forma predeterminada, tendrás que solicitar manualmente una revisión de Copilot en cada solicitud de cambios.
Puedes habilitar las revisiones automáticas de Copilot en todas las solicitudes de cambios mediante conjuntos de reglas configurados en el nivel de repositorio o de organización. Para obtener más información, vea «Acerca de los conjuntos de reglas».
Para activar esta opción, habilita la regla de rama Request pull request review from Copilot, anidada en Require a pull request before merging.
Personalización de las revisiones de Copilot con instrucciones de codificación
Note
Custom coding guidelines are currently only available to selected participants in the versión preliminar pública of Copilot code review. Being accepted from the waitlist does not provide immediate access. In addition, custom coding guidelines are only available as part of a subscription to GitHub Copilot Enterprise.
When using Copilot code review to review changes in Visual Studio Code or the GitHub website, you can customize Copilot's review with custom coding guidelines written in natural language. Copilot will give feedback based on your coding guidelines when it reviews your code. For more information, see "Configuring coding guidelines for GitHub Copilot code review."
Comments generated based on a coding guideline will include a message, highlighting their source.
Estas instrucciones explican cómo usar la Copilot code review en Visual Studio Code. Para ver instrucciones del sitio web de GitHub, usa el conmutador de herramientas "Web browser" en la parte superior de la página.
Note
La Copilot code review solo está disponible en Visual Studio Code con la versión 0.22 o posterior de la extensión de GitHub Copilot Chat.
Revisión de una selección de código
Puedes solicitar una revisión inicial de una selección de código resaltada en Visual Studio Code.
-
En Visual Studio Code, selecciona el código que quieres revisar.
-
Apertura de VS Code Command Palette
- Para Mac:
- Presiona: Mayús+Comando+P
- Para Windows o Linux:
- Presiona Ctrl+Mayús+P
- Para Mac:
-
En la paleta de comandos, busca la opción GitHub Copilot: Review and Comment y selecciónala.
-
Espera a que Copilot revise tus cambios. Esto suele tardar menos de 30 segundos.
-
Si Copilot tiene comentarios, estos se mostrarán insertados en el archivo y en la pestaña Problems.
Revisión de cambios
Note
Actualmente, la revisión de cambios solo está disponible para un número limitado de suscriptores de Copilot. Para unirte a la lista de espera, consulta "Unirse a la lista de espera de la Copilot code review".
Puedes solicitar una revisión para los cambios "staged" o "unstaged" en Visual Studio Code.
-
En VS Code, cambia a la pestaña Source Control.
-
Para solicitar una revisión de los cambios "unstaged", mantén el puntero sobre Changes en la barra lateral y, a continuación, haz clic en el botón Copilot code review - Changes.
-
Para solicitar una revisión de los cambios "staged", mantén el puntero sobre Staged Changes en la barra lateral y, a continuación, haz clic en el botón Copilot code review - Staged Changes.
-
Espera a que Copilot revise tus cambios. Esto suele tardar menos de 30 segundos.
-
Si Copilot tiene comentarios, estos se mostrarán insertados en los archivos y en la pestaña Problems.
Cómo trabajar con los cambios sugeridos que proporciona Copilot
Siempre que es posible, los comentarios de Copilot incluyen cambios sugeridos que puedes aplicar con un solo clic.
Si estás de acuerdo con el cambio, haz clic en el botón Apply and Go To Next para aceptar una sugerencia de Copilot. Los cambios que apliques no se confirmarán de forma automática.
Si no quieres aplicar un cambio sugerido por Copilot, haz clic en el botón Discard and Go to Next.
Comentarios sobre las revisiones de Copilot
Puedes responder a los comentarios de Copilot directamente dentro de cada comentario. Usamos esta información para mejorar el producto y la calidad de las sugerencias de Copilot.
Para proporcionar comentarios, mantén el puntero sobre el comentario y haz clic en el botón de pulgar hacia arriba o hacia abajo.
Personalización de las revisiones de Copilot con instrucciones de codificación
Note
Custom coding guidelines are currently only available to selected participants in the versión preliminar pública of Copilot code review. Being accepted from the waitlist does not provide immediate access. In addition, custom coding guidelines are only available as part of a subscription to GitHub Copilot Enterprise.
When using Copilot code review to review changes in Visual Studio Code or the GitHub website, you can customize Copilot's review with custom coding guidelines written in natural language. Copilot will give feedback based on your coding guidelines when it reviews your code. For more information, see "Configuring coding guidelines for GitHub Copilot code review."
Comments generated based on a coding guideline will include a message, highlighting their source.