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í |
/pr automerge | Haga lo mismo que /pr autoy, a continuación, combine la solicitud de incorporación de cambios una vez que sea verde.
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:
/pr
/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:
/pr view web
/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:
/pr create
/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:
/pr create prefix the PR title 'Project X: '
/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:
/pr fix feedback
/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.
Para cada subproceso que direcciona, Copilot responde dentro del subproceso en GitHub.com para explicar el cambio y, a continuación, marca el subproceso como resuelto. Los hilos que requieren tu intervención han sido respondidos, pero siguen sin resolverse.
Resolución de conflictos de combinación
Para sincronizar la rama con la rama base y resolver los conflictos de combinación, escriba:
/pr fix conflicts
/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, Copilot CLI 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.jsonen la raíz del repositorio.
Arreglando fallos de CI
Para que Copilot diagnostique y corrija comprobaciones de CI fallidas, escriba:
/pr fix ci
/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:
/pr fix ci focus on test failures
/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:
/pr fix
/pr fix
Esto ejecuta tres fases en orden secuencial:
- Retroalimentación de revisión : aborda todos los comentarios de la revisión.
- Conflictos : sincroniza la rama con la rama base y resuelve los conflictos.
- 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:
/pr auto
/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. No fusiona la pull request.
El bucle se ejecuta con una programación a su propio ritmo en lugar de como una única ejecución continua, realizando una pasada de trabajo cada vez que se ejecuta y haciendo una pausa entre pasadas mientras la CI se estabiliza. Use el /every comando de barra diagonal para comprobar el bucle o para detenerlo.
Puedes anexar instrucciones para guiar la creación de la solicitud de incorporación de cambios. Por ejemplo:
/pr auto include migration notes in the description
/pr auto include migration notes in the description
Fusión automática de la solicitud de extracción
/pr auto deliberadamente se detiene cuando la solicitud de incorporación de cambios es verde. Si también desea que Copilot fusione la solicitud de incorporación de cambios, escriba:
/pr automerge
/pr automerge
Esto ejecuta el mismo bucle que /pr auto. Una vez que la pull request deja de ser un borrador, no tiene solicitudes de cambios sin resolver y se han superado todas las comprobaciones requeridas, Copilot habilita la fusión automática en lugar de fusionar la propia pull request.
GitHub después completa la fusión tan pronto como se hayan cumplido todos los requisitos restantes, incluidas las aprobaciones necesarias y la cola de fusión.
Copilot mantiene el bucle en ejecución, controlando los comentarios de revisión o los errores de comprobación adicionales, hasta que la solicitud de incorporación de cambios se combina o cierra.
Puede usar /pr agentmerge como alias para /pr automerge.