Gestión de pull requests con el comando /pr

Use el /pr comando de barra diagonal para ver, crear y corregir solicitudes de incorporación de cambios 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 la solicitud de incorporación de cambios, crear nuevas solicitudes de incorporación de cambios y corregir problemas comunes, como los comentarios de revisión, los conflictos de combinación y los errores 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 confirmar e insertar
/pr o /pr view Muestra el estado del pull request para la rama actual. Más información Sí No
/pr view web Abra la solicitud de incorporación de cambios en el explorador. 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 Aborde los comentarios de revisión en la solicitud de incorporación de cambios. 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 las comprobaciones de CI con errores. Más información Sí Sí
/pr fix o /pr fix all Ejecute las tres fases de corrección en orden: comentarios, conflictos y 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

Apertura de 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 garantiza que todas las confirmaciones locales se transfieran a la rama remota y luego 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.

Adición de instrucciones para la creación de "pull requests"

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 aborde los comentarios de revisión en su solicitud de incorporación de cambios, introduzca:

Copilot prompt
/pr fix feedback

          Copilot captura todos los subprocesos de comentarios de revisión en la solicitud de incorporación de cambios, determina qué cambios se solicitan, aplica los cambios a su código base y confirma e inserta 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 captura la última rama base, sincroniza tu rama, resuelve cualquier conflicto y pushea 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/config.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 la creación hasta un estado totalmente verde, escriba:

Copilot prompt
/pr auto

Si no existe ninguna solicitud de incorporación de cambios para la rama actual, Copilot cree una en primer lugar. 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