Ir al contenido

Revisar y fusionar una PR

Esta guía te muestra cómo revisar y fusionar una pull request.

  1. Ve a Pull requests en la barra lateral
  2. Selecciona una PR de la lista

Una PR se abre como un banco de trabajo con pestañas, no como una sola página. Cinco pestañas se abren de forma predeterminada, en este orden: Resumen, Diff, Control de código fuente, Chat y Acciones (las comprobaciones de CI agrupadas por flujo de trabajo). Revisar —el progreso del pipeline de revisión y, después, el artefacto que publicó con su carril de hallazgos— no es una de ellas a propósito: una PR no tiene revisión hasta que alguien la pide, así que Ask AI la abre. Un terminal, un editor de un solo archivo, un code-server integrado y un navegador dentro de la aplicación se abren a demanda; las pestañas de despliegue de vista previa se inyectan automáticamente cuando se detecta una URL de vista previa en la PR. La disposición de tus pestañas se recuerda por PR.

El code-server integrado se ofrece solo al propietario del servidor, porque se ejecuta en el servidor como el propio usuario del servidor. Una sesión pertenece al dispositivo y a la persona que la abrió, se abre con la confianza del espacio de trabajo de VS Code activada (VS Code pregunta antes de confiar en una carpeta) y no ejecuta ninguna tarea automáticamente. Todos los demás conservan el editor de un solo archivo y las vistas de archivos.

La pestaña Resumen contiene los metadatos de la PR (autor, rama, etiquetas, asignados, reacciones, commits, estado de las comprobaciones) y la fila de acciones: actualizar, Revisar, Merge, un botón con el nombre de tu editor (como Abrir en VS Code) y un menú de desbordamiento ⋯.

Ese botón del editor inicia un editor nativo en la pantalla del servidor, como el usuario del servidor y fuera de cualquier sandbox, así que solo se ofrece al propietario del servidor. En un escritorio que aloja su propio servidor, esa es la persona sentada frente al equipo. Lo mismo aplica a abrir el worktree de una conversación en un editor. Los demás usan las vistas de editor integradas. Incluso para el propietario, una PR solo se abre desde un repositorio vinculado al espacio de trabajo.

La sección General → Pull requests del espacio agrupa por repositorio las PRs vinculadas y las que coinciden por su rama. Cuando la rama base de una PR es la rama head de la PR anterior, aparecen en una pila plegable. Su encabezado identifica la PR de abajo, la rama de destino y el número de PRs; las filas numeradas van de la PR de abajo (1) hacia la punta. Los números describen el orden de dependencia, no si una PR está lista para fusionarse.

Cada fila muestra el título, el número de la PR y su estado. Pasa el cursor o enfoca una fila para leer el título completo y los nombres de las ramas; haz clic o presiona Enter para abrir el banco de trabajo de la PR. Enfoca el encabezado de una pila y presiona Enter o Espacio para contraerla o expandirla. Las PRs no relacionadas se mantienen separadas, y los vínculos de rama incompletos o ambiguos no se presentan como una pila ordenada.

En el encabezado de la PR, la insignia de la pila (un icono de capas con el número de pull requests de la pila) abre Pull requests apiladas, un selector de las partes publicadas de la pila, de abajo hacia arriba. Cada entrada muestra el número de la PR, la etiqueta de la parte y su posición; se marca la parte que tienes en checkout. Selecciona una entrada para abrir el banco de trabajo de su PR. Publicar la pila solo aparece cuando la detección de PRs ha terminado y al menos una parte no tiene PR. Esto también aplica al menú de rama. Las PRs creadas fuera de Control Center también cuentan como publicadas. Las pilas publicadas parcialmente ofrecen ambas acciones; el trabajo de una sola rama mantiene las acciones individuales de crear y ver la PR.

Hacer commit y push desde Control de código fuente

Sección titulada «Hacer commit y push desde Control de código fuente»

Un commit que haces en el panel Control de código fuente es tuyo: tú eres su autor y su committer, con la dirección que tu forja verificó para tu inicio de sesión. Cuando creaste una clave de firma en Commits verificados dentro de Ajustes → Tú → Commits, el servidor lo firma con tu propia clave de firma antes de hacer push. Un push lleva tu propio inicio de sesión, limitado a ese único repositorio.

El servidor ejecuta Git en su propia máquina, en un árbol que un agente o una pull request pueden cambiar, así que no ejecuta ninguno de los programas que un repositorio puede elegir:

  • Los commits omiten los hooks de Git del repositorio, igual que git commit --no-verify. Un hook pre-commit, un hook commit-msg o un hook pre-push no se ejecutan
  • Se ignoran los auxiliares de credenciales, los editores, las herramientas de diff externas y los programas de firma que configure el repositorio

Ejecuta tus comprobaciones tú mismo antes de hacer commit, o en CI.

Cambiar el código requiere una concesión de escritura sobre el repositorio: guardar o revertir archivos en el editor, Obtener los últimos commits de la PR, hacer commit y push, publicar una rama, y las acciones de la pila que cortan, hacen checkout o publican una parte. Con solo acceso de lectura o revisión ves los archivos y los diffs, y estas acciones responden «Puedes leer este repositorio, pero no modificarlo. Un administrador del espacio de trabajo puede conceder acceso de escritura.»

Obtener los últimos commits de la PR trae el worktree de revisión a los commits más recientes de la pull request. Lo obtiene con tu propio inicio de sesión de GitHub, y te pide que inicies sesión si no tienes ninguno. Confirma o descarta tus cambios primero: un worktree con cambios sin confirmar no se sincroniza.

Abre la pestaña Diff para ver todo el diff de la PR de una vez, con un árbol de archivos para saltar entre archivos.

  • El botón de ajustes de la barra de herramientas del diff alterna entre la vista dividida (en paralelo) y la unificada, y activa o desactiva el ajuste de líneas y las ligaduras de la fuente de código.
  • Los encabezados de fragmento @@ se sustituyen por los controles Show N lines / Show end of file, que insertan el contexto circundante al hacer clic.
  • Presiona j / k para pasar de un archivo a otro, c para contraer o expandir el archivo enfocado, t para devolver la barra lateral al árbol de archivos y ⌘F para buscar en todo el diff (Enter / Shift+Enter recorren las coincidencias).
  • Presiona v para marcar el archivo enfocado como visto, y el cursor avanza hasta el siguiente archivo. En GitHub el estado de visto se guarda en el host de código, así que te acompaña entre clientes; GitLab y Bitbucket no tienen esa API, así que ahí solo se recuerda en este dispositivo.

Arrastrar con el mouse en el área de código selecciona el texto hasta la columna exacta, y ⌘C copia el código fuente sin procesar en lugar de los marcadores de diff representados.

  1. Toca el margen de una fila de código para abrir un compositor anclado a esa línea, o usa el botón + del encabezado de un archivo para un comentario a nivel de archivo
  2. Escribe tus comentarios en Markdown
  3. Envía

En GitHub y GitLab el compositor ofrece dos envíos: Añadir un solo comentario publica de inmediato, e Iniciar una revisión / Añadir a la revisión pone el comentario en cola en una revisión pendiente que se envía con Aprobar, Solicitar cambios o Comentar. Bitbucket no tiene agrupación de revisiones pendientes, así que ahí cada envío publica de inmediato. Una publicación inmediata muestra un estado pendiente hasta que el host de código la confirma y luego pasa a sincronizado. Si la publicación falla, el hilo se marca con el error y ofrece reintentarlo.

Solo el cuerpo de la revisión es un borrador: se guarda en el servidor asociado a (propietario, repo, número de PR) un momento después de que dejas de escribir, así que sobrevive a una recarga y te acompaña entre los clientes de escritorio y web.

  1. Presiona Revisar en la fila de acciones de Resumen (se oculta en tus propias PRs y en una PR cerrada o fusionada)
  2. Escribe el cuerpo de la revisión. Puedes adjuntar una imagen, insertar un emoji o un GIF y alternar entre escribir y la vista previa
  3. Presiona Solicitar cambios, Comentar o Aprobar

El veredicto es el botón: no hay un selector de veredicto aparte. Después de Aprobar o Solicitar cambios, el botón se renombra a Aprobado o Cambios solicitados y se borra el cuerpo del borrador. Un veredicto Comentar deja el botón con la etiqueta Revisar.

El botón Merge aparece cuando tienes acceso de escritura y la PR está abierta y no es un borrador. Su color es una señal de preparación derivada de las aprobaciones obligatorias y el estado de las comprobaciones (listo / pendiente / bloqueado); solo es orientativa. El estado de la revisión nunca desactiva el botón; es la propia protección de rama del host de código la que aplica las reglas.

  1. Presiona Merge para abrir el panel flotante de fusión
  2. Elige un método de fusión: squash, merge commit o rebase (squash es el predeterminado). Bitbucket no tiene una fusión con rebase real, así que rebase se corresponde con su estrategia fast-forward y falla en una rama divergente
  3. Para squash y merge commit, edita el título y la descripción del commit precargados. Rebase no admite ninguno de los dos y oculta ambos campos
  4. Lee el panel de advertencias: nombra las comprobaciones que fallan y las revisiones pendientes, pero no te bloquea
  5. Presiona el botón de fusión del panel flotante para confirmar

Fusionar es irreversible: envía los commits al host de código, por lo que recibe un paso de confirmación en lugar de una entrada de deshacer. Después, la caché de la PR se invalida, su estado pasa a Fusionado y se desencadena un evento PullRequestStatusChanged con el estado merged. Ese evento libera el worktree efímero que abrió el botón del editor e inicia dos pipelines predefinidos: Stale repository cleanup, que elimina los worktrees obsoletos y las carpetas de conversación de la PR, y Release notes, que redacta una entrada de changelog.

El menú de desbordamiento ⋯ de la pestaña Resumen contiene Ask AI, que inicia el pipeline predefinido pr_review para esta PR. Solo aparece mientras la PR está abierta. Consulta Usar revisión impulsada por IA para saber qué hace el pipeline y cómo publicar sus hallazgos, y Cómputo de revisión para ver el modelo determinista de cohortes y ejes.

Control Center también importa PRs abiertas por personas fuera de la aplicación. El flujo de revisión anterior es idéntico. El servicio de sondeo de PRs detecta las PRs externas.

Los commits hechos en el panel Control de código fuente de la app omiten los hooks de Git del repositorio, igual que git commit --no-verify. El servidor ejecuta Git en su propia máquina, en un árbol que los agentes y las pull requests pueden cambiar, así que nunca ejecuta un programa que elija el repositorio. Ejecuta tú mismo las comprobaciones del hook, o confía en CI.