Revisa tu primera pull request

Qué vas a crear

Al terminar este tutorial, tendrás:

• Abierto una pull request en el banco de trabajo de PRs de Control Center
• Leído su diff y dejado un comentario en línea
• Enviado un veredicto de revisión
• Fusionado la PR

Requisitos previos: Despacha tu primer agente completado y una pull request abierta en un repo registrado en este espacio de trabajo. Para los pasos de revisión, elige una PR que no hayas abierto tú: el botón Revisar se oculta en tus propias PRs. La fusión sí funciona en una PR que hayas creado tú.

Paso 1: Abrir la pull request

1. Haz clic en Pull requests en la barra lateral
2. Busca tu PR y haz clic en ella

Punto de control. La PR se abre como un banco de trabajo con pestañas —Resumen, Diff, Control de código fuente, Chat y Acciones— centrado en Resumen: el título y las acciones, la descripción y la cronología de actividad, y una barra lateral con el estado, los revisores, los asignados, las comprobaciones y los archivos modificados. Si haces clic en un archivo de ahí, saltas a él en la pestaña Diff. La pestaña Revisar no se abre hasta que alguien pide una revisión con IA.

Cola vacía con un aviso de «conectar GitHub»

Ese estado significa que el servidor no guarda ningún token de GitHub: tu cliente nunca guarda uno. Configúralo en Ajustes → Espacio de trabajo → Perfil e identidad → Alojamiento de código y, después, actualiza la lista.

Paso 2: Leer el diff

Abre la pestaña Diff. A la izquierda tienes un árbol de archivos plegable, y la franja situada sobre el diff incluye un selector de rango de commits —para acotar el diff a un commit o a un tramo de ellos— además del número de archivos y el recuento acumulado de adiciones y eliminaciones.

El botón de ajustes de la barra de herramientas del diff controla cómo se representa:

• Vista dividida o unificada
• Ajustar líneas o desplazar las líneas largas
• Ligaduras de la fuente de código

Marca un archivo como visto para hacer seguimiento de tu progreso en un diff grande. La navegación por teclado está en Atajos de teclado.

Paso 3: Dejar un comentario en línea

1. Pasa el cursor por encima de una línea del diff: aparece un pequeño botón + en el margen
2. Haz clic en él para comentar esa línea, o arrástralo en vertical antes para seleccionar un rango
3. Escribe tus comentarios. El compositor ofrece dos formas de enviar:
   • Iniciar una revisión (o Añadir a la revisión si ya hay una revisión en curso) pone el comentario en cola. El hilo muestra Revisión pendiente hasta que envíes un veredicto en el paso 4.
   • Añadir un solo comentario lo publica en GitHub de inmediato. El hilo muestra Publicando…, luego Sincronizado, y ofrece reintentarlo si la publicación falla.

Para este tutorial, usa Iniciar una revisión para que el comentario salga con el veredicto.

Un comentario en cola aún no está en GitHub

Iniciar una revisión / Añadir a la revisión guardan el comentario en local hasta que envíes un veredicto. Solo Añadir un solo comentario publica de inmediato. El cuerpo de la revisión que escribes en el paso 4 es un borrador aparte.

Paso 4: Enviar una revisión

1. Haz clic en Revisar en la fila de acciones de Resumen: el mismo botón también está en la barra de herramientas de la pestaña Diff. Se oculta en las PRs que hayas creado tú y en una PR cerrada o fusionada.
2. Escribe un resumen en el compositor. Se guarda automáticamente como borrador, así que puedes cerrar la capa superpuesta y volver más tarde.
3. Elige un veredicto:
   • Solicitar cambios
   • Comentar
   • Aprobar

El veredicto es el botón. Después de Aprobar o Solicitar cambios, el botón se renombra a Aprobado o Cambios solicitados. Un veredicto Comentar deja el botón con la etiqueta Revisar.

Punto de control. El botón pone «Aprobado» o «Cambios solicitados» si elegiste uno de esos dos.

Paso 5: Fusionar

El botón Merge está presente siempre que GitHub indique que la PR se puede fusionar; no depende de tu propia aprobación. Su color indica disponibilidad, no permiso: primario cuando las aprobaciones obligatorias y las comprobaciones están en verde, secundario mientras una comprobación sigue en curso y destructivo cuando un revisor solicitado no ha aprobado o una comprobación está fallando.

1. Haz clic en Merge
2. Elige un método: Squash and merge, Create a merge commit o Rebase and merge
3. En los dos primeros, edita el título y el mensaje del commit precargados
4. Confirma

Cualquier problema pendiente —«Comprobaciones fallidas», «Some reviews are pending»— aparece en el panel flotante antes de que confirmes.

Fusionar es irreversible

Fusionar envía commits a GitHub. Nunca entra en la pila de deshacer de Control Center y no se puede deshacer desde aquí.

Tras fusionar, se desencadena un evento de dominio PrMerged; la analítica y las notificaciones lo consumen. Consulta Eventos de dominio para saber qué más lo escucha.

Revisar con IA

Control Center puede poner un pipeline de revisión sobre una PR abierta, pero solo cuando tú se lo pides: la plantilla pr_review tiene un disparador manual y nada más.

1. Abre el menú de desbordamiento de la fila de acciones de Resumen y elige Ask AI. Control Center inicia la ejecución y abre la pestaña Revisar, para que puedas ver cómo trabajan los especialistas.
2. Los agentes revisores registran sus hallazgos como nodos de revisión en el espacio de la PR; un paso final los consolida en un único informe.

El pipeline no publica en GitHub a propósito: termina después de consolidar. La publicación es un paso aparte que das tú mismo, con el botón Publicar en GitHub de la pestaña Revisar. Consulta Usar revisión con IA.

Recapitulación

Has abierto una PR en el banco de trabajo, has leído el diff con resaltado de sintaxis, has dejado un comentario en línea, has enviado un veredicto y has fusionado, todo sin salir de la aplicación.

Siguiente: Crea tu primer pipeline para automatizar flujos de trabajo de varios pasos.