Skip to main content

Uso de la revisión de código de GitHub Copilot

Obtén información sobre cómo solicitar una revisión de código de GitHub Copilot.

Note

Acerca de la Revisión del código de Copilot

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 Revisión del código de Copilot 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ísticaRevisión de la selecciónRevisión de los cambios
EntornoVisual Studio CodeVisual Studio Code y el sitio web de GitHub
DescripciónRevisión inicial de una sección resaltada del código con comentarios y sugerenciasRevisión más minuciosa de todos los cambios
Compatibilidad con idiomasAllC#, Go, Java, JavaScript, Markdown, Python, Ruby, TypeScript
Compatibilidad con instrucciones de codificación personalizadasNoSí, consulta Personalización de las revisiones de Copilot con instrucciones de código
Disponibilidadversión preliminar pública, disponible para todos los suscriptores de Copilotversión preliminar pública con lista de espera, consulta "Unirse a la lista de espera de la Revisión del código de Copilot"

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 Revisión del código de Copilot 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 solicitud de 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 Revisión del código de Copilot".

  1. En GitHub.com, cree una solicitud de incorporación de cambios o vaya a una solicitud de incorporación de cambios existente.

  2. Abre el menú Reviewers y, a continuación, selecciona Copilot.

    Captura de pantalla de la selección de "Copilot" en el menú "Reviewers".

  3. Espera a que Copilot revise tu solicitud de cambios. Esto suele tardar menos de 30 segundos.

  4. Desplázate hacia abajo y lee los comentarios de Copilot.

    Captura de pantalla de una revisión de código 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".

  5. 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 hacer "commit" de ella, o bien aceptar un grupo de sugerencias de forma conjunta en un solo commit. 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 «Uso de Copilot para ayudarte a trabajar con una solicitud de cambios».

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.

  1. 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 (👎).

    Captura de pantalla que muestra un comentario de la Revisión del código de Copilot con los botones de pulgar hacia arriba y hacia abajo.

  2. 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.

    Captura de pantalla del formulario para proporcionar información adicional al enviar comentarios negativos sobre una entrada de Copilot.

Solicitud de nueva revisión de Copilot

Al hacer "push" de 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.

Captura de pantalla de la regla de rama "Request pull request review from Copilot".

Personalización de las revisiones de Copilot con instrucciones de codificación

Note

Actualmente, las instrucciones de codificación personalizadas solo están disponibles para los participantes seleccionados en la versión preliminar pública de la Revisión del código de Copilot. La aceptación en la lista de espera no proporciona acceso inmediato. Además, las instrucciones de codificación personalizadas solo están disponibles como parte de una suscripción a GitHub Copilot Enterprise.

Al usar la Revisión del código de Copilot para revisar los cambios en Visual Studio Code o el sitio web de GitHub, puedes personalizar la revisión de Copilot con instrucciones de codificación personalizadas escritas en lenguaje natural. Copilot proporcionará comentarios basados en las instrucciones de codificación cuando revise el código. Para obtener más información, vea «Configuración de instrucciones de codificación para la revisión de código de GitHub Copilot».

Los comentarios generados en función de una referencia de codificación incluirán un mensaje indicándose su origen.

Captura de pantalla de un comentario generado a partir de una instrucción de codificación personalizada.

Estas instrucciones explican cómo usar la Revisión del código de Copilot 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 Revisión del código de Copilot 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.

  1. En Visual Studio Code, selecciona el código que quieres revisar.

  2. Apertura de VS Code Command Palette

    • Para Mac:
      • Presiona: Mayús+Comando+P
    • Para Windows o Linux:
      • Presiona Ctrl+Mayús+P
  3. En la paleta de comandos, busca la opción GitHub Copilot: Review and Comment y selecciónala.

    Captura de pantalla de la paleta de comandos en Visual Studio Code con el comando GitHub Copilot: Review and Comment seleccionado.

  4. Espera a que Copilot revise tus cambios. Esto suele tardar menos de 30 segundos.

    Captura de pantalla del indicador de progreso cuando Copilot realiza una revisión en Visual Studio Code.

  5. Si Copilot tiene comentarios, estos se mostrarán insertados en el archivo y en la pestaña Problems.

    Captura de pantalla de un comentario de Copilot en Visual Studio Code.

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 Revisión del código de Copilot".

Puedes solicitar una revisión para los cambios "staged" o "unstaged" en Visual Studio Code.

  1. En VS Code, cambia a la pestaña Source Control.

  2. 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 Revisión del código de Copilot - Changes.

    Captura de pantalla del botón "Revisión del código de Copilot - Changes" en Visual Studio Code. El botón de revisión del código está resaltado en naranja oscuro.

  3. 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 Revisión del código de Copilot - Staged Changes.

  4. Espera a que Copilot revise tus cambios. Esto suele tardar menos de 30 segundos.

    Captura de pantalla del indicador de progreso cuando Copilot realiza una revisión en Visual Studio Code.

  5. Si Copilot tiene comentarios, estos se mostrarán insertados en los archivos y en la pestaña Problems.

    Captura de pantalla de un comentario de Copilot en Visual Studio Code.

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.

Captura de pantalla de un comentario de Copilot en Visual Studio Code con un cambio sugerido.

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.

Captura de pantalla de un comentario de Copilot en Visual Studio Code donde se muestran los botones de comentarios. Los botones están resaltados en naranja oscuro.

Personalización de las revisiones de Copilot con instrucciones de codificación

Note

Actualmente, las instrucciones de codificación personalizadas solo están disponibles para los participantes seleccionados en la versión preliminar pública de la Revisión del código de Copilot. La aceptación en la lista de espera no proporciona acceso inmediato. Además, las instrucciones de codificación personalizadas solo están disponibles como parte de una suscripción a GitHub Copilot Enterprise.

Al usar la Revisión del código de Copilot para revisar los cambios en Visual Studio Code o el sitio web de GitHub, puedes personalizar la revisión de Copilot con instrucciones de codificación personalizadas escritas en lenguaje natural. Copilot proporcionará comentarios basados en las instrucciones de codificación cuando revise el código. Para obtener más información, vea «Configuración de instrucciones de codificación para la revisión de código de GitHub Copilot».

Los comentarios generados en función de una referencia de codificación incluirán un mensaje indicándose su origen.