Propuestas de fusión
Descripción general
Una propuesta de fusión registra una solicitud para fusionar los cambios de una rama en otra y permite que un compañero revise el diff antes de que ocurra. Cualquier persona con acceso de edición al agente puede abrir una propuesta, incluso hacia una rama que no pueda fusionar por sí misma. Fusionar la propuesta sigue requiriendo acceso de escritura a la rama de destino, por lo que una propuesta permite que un cambio llegue a una rama protegida sin dar a cada colaborador permisos de fusión en ella.
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 cuando quieras que alguien la revise primero o cuando la rama de destino esté protegida y no tengas acceso de escritura a ella.
Disponibilidad
Las propuestas de fusión están en alfa. Cuando varias ramas de un agente están en curso a la vez, resulta difícil controlar cuáles están listas y se pueden fusionar de forma segura. Las propuestas de fusión ofrecen a un 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 versión alfa es un primer paso hacia un flujo de trabajo estilo CI/CD para agentes, similar a las solicitudes de extracción en GitHub. Las adiciones previstas para 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, revisores emiten uno de estos veredictos. El último veredicto de un revisor sustituye cualquier veredicto anterior de ese mismo revisor:
Abrir una propuesta
Abre una propuesta desde la rama cuyos cambios quieres que se revisen:
Desde la lista de ramas
Desde la pestaña Proposals
En la pestaña Branches del agente, abre el menú de opciones de la rama de origen y selecciona **Open merge proposal **.
Asigna un título a la propuesta, añade una descripción opcional y elige una rama de destino entre las demás ramas no archivadas del agente. Abrir una propuesta no cambia ninguna de las 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:
Descripción general
Cambios
Ejecuciones de pruebas
Conversaciones
La descripción, el historial de revisiones y un formulario para dejar una revisión.
Cualquier persona con acceso de edición al agente, excepto 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 la fusión directa, incluida la resolución de conflictos y la opción de archivar la rama de origen después. Antes de poder fusionarse, una propuesta debe cumplir estos requisitos:
- El usuario que realiza la fusión tiene acceso de escritura a las ramas de origen y destino. En una rama protegida, eso significa ser administrador del espacio de trabajo.
- El último veredicto de ningún revisor es “cambios solicitados”. Un revisor que haya solicitado cambios debe aprobar antes de poder fusionar la propuesta.
- La propuesta tiene al menos una aprobación de alguien que no sea su autor. 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 se puede cerrar sin fusionarla en cualquier momento mientras esté abierta. El autor y revisores pueden editar su título y descripción hasta que se cierre.
- Cuando el autor cierra su propia propuesta, se registra como retirada.
- Cuando la cierra cualquier otra persona, se registra como rechazada.
- Archivar la rama de origen cierra automáticamente cualquier propuesta abierta desde o hacia ella, registrada como branch_archived.
Propuestas de fusión y ElevenAgents Architect
Architect puede abrir propuestas de fusión por ti. Después de realizar y probar un cambio en una rama, lee los commits y la vista previa de fusión de la rama y abre una propuesta con las secciones Resumen, Pruebas y Cómo revisar. También puede sugerir revisores para que elijas. Como Architect actúa como tú, la propuesta te indica como autor.
Architect no puede revisar, aprobar, fusionar ni cerrar una propuesta. Estos pasos siempre los realizan personas. Consulta Propuestas y validación para ver el flujo completo.