Gestión de pull requests con el comando /pr

Utilice el comando de barra /pr para ver, crear y corregir solicitudes de extracción directamente desde CLI de Copilot.

En este artículo

Visión general

El /pr comando slash le permite administrar el ciclo de vida completo de la solicitud de pull request sin salir de su terminal. Puede comprobar el estado de las solicitudes de extracción, crear nuevas solicitudes de extracción y corregir problemas comunes, como comentarios de revisión, conflictos de fusión y fallos de CI.

Prerrequisito

Debe estar trabajando en un repositorio de Git hospedado en GitHub.

Subcomandos

El comando slash /pr tiene varios subcomandos que puedes usar para realizar diferentes acciones en los pull requests.

Nota:

Todos los /pr subcomandos se relacionan con la rama actual, por ejemplo, corregir las comprobaciones de CI con errores para el pull request asociado a la rama actual.

Use este subcomando Para hacer esto Requiere una solicitud de incorporación de cambios existente Puede realizar confirmaciones y envíos
/pr o /pr view Mostrar el estado de la solicitud de extracción para la rama actual. Más información Sí No
/pr view web Abrir la solicitud de extracción en su navegador. Más información Sí No
/pr create Cree o actualice una solicitud de incorporación de cambios. Más información No Sí
/pr fix feedback Responder a los comentarios de revisión en la solicitud de extracción. Más información Sí Sí
/pr fix conflicts Sincronice la rama con la rama base y resuelva conflictos. Más información Sí Sí
/pr fix ci Diagnostique y corrija los fallos en las comprobaciones de CI. Más información Sí Sí
/pr fix o /pr fix all Ejecute las tres fases de corrección en orden: comentarios, conflictos y, por último, CI. Más información Sí Sí
/pr auto Cree una solicitud de incorporación de cambios si es necesario y, a continuación, recorra en bucle todas las fases de corrección hasta que se pasen todas las comprobaciones de solicitudes de incorporación de cambios. Más información No Sí

Los subcomandos que confirmen e inserten cambios le pedirán permiso antes de realizar acciones potencialmente destructivas, a menos que haya permitido previamente esas herramientas. Para obtener más información, vea Permitir y denegar el uso de la herramienta.

Ver el estado del pull request

Para comprobar el estado de la solicitud de incorporación de cambios asociada a la rama actual, escriba lo siguiente en una sesión interactiva:

Copilot prompt
/pr

Al abrir la solicitud de incorporación de cambios en el navegador

Si desea ver la solicitud de incorporación de cambios en GitHub.com en lugar de en la terminal, escriba:

Copilot prompt
/pr view web

Se abre la dirección URL de la solicitud de incorporación de cambios en el explorador predeterminado.

Crear una solicitud de incorporación de cambios

Para crear un pull request desde su rama actual, escriba:

Copilot prompt
/pr create

          Copilot se asegura de que todas las confirmaciones locales se envíen a la rama remota y, a continuación, crea la solicitud de incorporación de cambios. Si existe una plantilla de solicitud de incorporación de cambios en el repositorio, Copilot siguela al generar el título y la descripción de la solicitud de incorporación de cambios.

Si ya existe una solicitud de incorporación de cambios para la rama actual, /pr create actualiza la solicitud de incorporación de cambios existente en lugar de crear una nueva.

Añadir instrucciones para la creación de solicitudes de incorporación de cambios

Puede añadir instrucciones después de /pr create para guiar a Copilot. Por ejemplo:

Copilot prompt
/pr create prefix the PR title 'Project X: '

Corrección de comentarios de revisión

Para que Copilot lea y resuelva los comentarios de revisión de su solicitud de extracción, introduzca:

Copilot prompt
/pr fix feedback

          Copilot recupera todos los hilos de comentarios de revisión de la solicitud de extracción, determina qué cambios se solicitan, aplica los cambios a su código base y realiza el commit y el push de las correcciones. Las solicitudes de cambio de código accionables tienen prioridad sobre los comentarios conversacionales.

Resolución de conflictos de combinación

Para sincronizar la rama con la rama base y resolver los conflictos de combinación, escriba:

Copilot prompt
/pr fix conflicts

          Copilot recupera la rama base más reciente, sincroniza su rama, resuelve cualquier conflicto y envía el resultado.

Elección de una estrategia de combinación

Al resolver conflictos, CLI de Copilot necesita saber si debe utilizar una estrategia de rebase o de fusión. Si no ha configurado una preferencia, Copilot le pedirá que elija al ejecutar un comando que implique la resolución de conflictos.

Para establecer una estrategia de combinación predeterminada para que no se le solicite cada vez, agregue la mergeStrategy configuración al archivo de configuración. Puede establecerlo en la configuración de usuario personal para Copiloto en la configuración del repositorio.

  • Configuración del usuario: agregue "mergeStrategy": "rebase" o "mergeStrategy": "merge" al archivo de configuración de nivel de usuario (normalmente ~/.copilot/settings.json).
  • Configuración del repositorio: agregue la misma configuración a .github/copilot/settings.json en la raíz del repositorio.

Arreglando fallos de CI

Para que Copilot diagnostique y corrija comprobaciones de CI fallidas, escriba:

Copilot prompt
/pr fix ci

          Copilot identifica los trabajos de CI con errores, analiza los registros para determinar las causas principales, aplica correcciones específicas y las implementa. A continuación, vuelve a comprobar el estado de CI y repite el proceso hasta que las comprobaciones se aprueban o bien determina que no es posible avanzar más.

Si los errores no están relacionados con los cambios de la rama, Copilot lo indica claramente para que pueda tomar las medidas adecuadas.

Puede anexar contexto adicional para ayudar Copilot a centrarse en errores específicos. Por ejemplo:

Copilot prompt
/pr fix ci focus on test failures

Corrección de todos los problemas a la vez

Para solucionar todos los problemas pendientes en una solicitud de incorporación de cambios en un solo comando, escriba:

Copilot prompt
/pr fix

Esto ejecuta tres fases en orden secuencial:

  1.        **Retroalimentación de revisión** : aborda todos los comentarios de la revisión.

  2.        **Conflictos** : sincroniza la rama con la rama base y resuelve los conflictos.

  3.        **Errores de CI** : diagnostica y corrige comprobaciones de CI con errores.

Automatización de todo el flujo de trabajo del pull request

Para que Copilot administre todo el proceso de solicitud de incorporación de cambios, desde su creación hasta que alcance un estado totalmente verde, introduzca:

Copilot prompt
/pr auto

Si no existe ninguna solicitud de incorporación de cambios para la rama actual, Copilot crea una primero. A continuación, recorre en bucle las fases de corrección: comentarios de revisión, conflictos y comprobaciones de CI, repitiendo hasta que no haya más comentarios de revisión, no haya conflictos y se superen todas las comprobaciones de CI.

Puedes anexar instrucciones para guiar la creación de la solicitud de incorporación de cambios. Por ejemplo:

Copilot prompt
/pr auto include migration notes in the description

Lectura adicional