Propuestas de fusión
Propuestas de fusión
Resumen
Una propuesta de fusión registra una solicitud para fusionar los cambios de una rama en otra y permite a un compañero revisar las diferencias antes de que ocurra. Cualquiera con acceso de edición al agente puede abrir una propuesta, incluso hacia una rama en la que no pueda fusionar cambios. Fusionar la propuesta sigue requiriendo acceso de escritura a la rama de destino, así que una propuesta permite que un cambio llegue a una rama protegida sin conceder permisos de fusión a cada colaborador.
Las propuestas de fusión añaden un paso de revisión opcional a la fusión directa de ramas. Fusiona directamente cuando tengas acceso de escritura a la rama de destino y no necesites una segunda opinión. Abre una propuesta si quieres que se revise primero o si la rama de destino está protegida y no tienes acceso de escritura a ella.
Disponibilidad
Las propuestas de fusión están en fase alfa. Cuando se desarrollan varias ramas de un agente a la vez, resulta difícil saber cuáles están listas y es seguro fusionar. Las propuestas de fusión ofrecen al equipo un lugar para revisar y comentar los cambios de una rama, comparar las tasas de aprobación de pruebas entre ramas y consultar las conversaciones más recientes de la rama.
La fase alfa es un primer paso hacia un workflow de estilo CI/CD para agentes, similar a las pull requests de GitHub. Las incorporaciones previstas durante las próximas semanas incluyen:
- Pruebas obligatorias que deben superarse antes de poder fusionar una propuesta.
- Solicitar aprobaciones a revisores específicos.
- Configurar responsables para distintas partes de un agente.
Ciclo de vida de una propuesta
Cada propuesta tiene uno de estos estados:
Mientras una propuesta está abierta, los revisores pueden emitir uno de estos veredictos. El último veredicto de un revisor reemplaza cualquier veredicto anterior de ese mismo revisor:
Abrir una propuesta
Abre una propuesta desde la rama cuyos cambios quieres revisar:
Desde la lista de ramas
Desde la pestaña Propuestas
En la pestaña Ramas del agente, abre el menú de opciones de la rama de origen y selecciona **Abrir propuesta de fusión **.
Asigna a la propuesta un título, una descripción opcional y elige una rama de destino entre las demás ramas no archivadas del agente. Abrir una propuesta no modifica ninguna de las dos ramas; solo registra la solicitud.
Un par de ramas de origen y destino puede tener como máximo una propuesta abierta a la vez. Cierra la existente antes de abrir otra entre las mismas dos ramas.
Revisar una propuesta
La página de una propuesta tiene estas pestañas:
Resumen
Cambios
Ejecuciones de pruebas
Conversaciones
La descripción, el historial de revisiones y un formulario para dejar una revisión.
Cualquiera con acceso de edición al agente, salvo el propio autor de la propuesta, puede dejar una revisión con un comentario opcional. Los comentarios admiten Markdown.
Fusionar una propuesta
Fusionar una propuesta realiza la misma fusión de ramas que una fusión directa, incluida la resolución de conflictos y la opción de archivar después la rama de origen. Antes de poder fusionarse, una propuesta debe cumplir estos requisitos:
- El usuario que realiza la fusión tiene acceso de escritura tanto a la rama de origen como a la de destino. En una rama protegida, eso implica ser administrador del espacio de trabajo.
- El último veredicto de ningún revisor es «cambios solicitados». Un revisor que solicitó cambios debe aprobar antes de que la propuesta pueda fusionarse.
- La propuesta cuenta con al menos una aprobación de alguien que no sea su autor. Los administradores del espacio de trabajo pueden fusionar sin esta aprobación.
Fusionar una propuesta cierra automáticamente cualquier otra propuesta abierta para la misma rama de origen, ya que sus cambios han avanzado.
Cerrar una propuesta
Una propuesta puede cerrarse sin fusionarse en cualquier momento mientras esté abierta. El autor y los revisores pueden editar su título y descripción hasta que se cierre.
- Si el autor cierra su propia propuesta, se registra como retirada.
- Si la cierra otra persona, se registra como rechazada.
- Archivar la rama de origen cierra automáticamente cualquier propuesta abierta desde o hacia ella, y se registra como branch_archived.
Propuestas de fusión y Architect
Architect tiene acceso de lectura a las ramas de un agente cuando le preguntas sobre ramas, versiones y fusiones, por lo que puede ayudarte a entender las diferencias de una propuesta o resumir las revisiones abiertas en una conversación.