Skip to main content
Cuando una tarea es demasiado grande para revisarla cómodamente en una sola PR, Devin puede dividirla en una pila: una serie ordenada de pull requests que conforman una misma unidad de trabajo y se integran juntas, de abajo hacia arriba. Cada PR de la pila es una PR normal y específica que se basa en la anterior; los revisores leen un cambio pequeño y autocontenido cada vez, en lugar de un único diff monolítico. Las pilas de Devin se basan en las pull requests apiladas nativas de GitHub, por lo que una pila es un objeto nativo de GitHub, no una convención basada en los nombres de las ramas.
Las PR apiladas solo son compatibles con repositorios de GitHub.com. GitHub Enterprise Server, GitLab y otros proveedores no disponen de una API para PR apiladas.

​
Cómo funciona una pila

Una pila es una serie de parches:
  • Las PR se ordenan de abajo hacia arriba. La PR inferior tiene como destino tu rama troncal (p. ej., main); la rama base de cada una de las demás PR es la rama principal de la PR situada debajo.
  • Como cada PR se compara con la capa inferior, cada una muestra solo sus propios cambios; no incluye cambios de las capas superiores ni inferiores.
  • La pila se integra de abajo hacia arriba. Al fusionar una PR de la pila, también se fusionan de forma atómica todas las PR abiertas situadas debajo, en una sola operación. A medida que se fusionan las PR inferiores, GitHub redirige automáticamente las PR restantes a la rama troncal.

​
Cuándo Devin crea una pila

Devin crea pilas de forma deliberada, no oportunista. Solo crea una pila cuando ha dividido intencionalmente una tarea en una serie ordenada de PR diseñadas para integrarse juntas; por ejemplo, un cambio de esquema, seguido de la capa de servicio que lo usa y, después, la UI que se apoya en ella. Las PR que simplemente se basan en la rama de otra PR no se agrupan en una pila. Cuando Devin planifica una pila:
  1. Anuncia la pila por nombre antes de crear ninguna PR, para que puedas ver cómo toma forma la serie en tu sesión.
  2. Crea cada PR como una PR normal y específica, con su propia descripción y su propia CI, y cada una dirigida a la rama principal de la PR que tiene debajo.
  3. Agrupa las PR en una pila en GitHub una vez creadas.
Cada capa cumple el mismo estándar que cualquier PR independiente que entrega Devin: un diff mínimo y específico, y una descripción informativa escrita para un revisor que no ha visto el código.

​
Mantener la coherencia de la pila

Una pila no queda congelada una vez creada. Devin permanece vinculado a cada PR de la pila durante toda la sesión:
  • Resolución de conflictos — Si alguna capa genera conflictos de fusión con la rama inferior (por ejemplo, después de incorporar comentarios de revisión en una capa inferior o de que la rama troncal avance por debajo de la pila), Devin recibe una notificación automáticamente y resuelve los conflictos sin intervención. Solo te consulta cuando un conflicto implica una decisión importante que requiere tu intervención.
  • CI en toda la pila — Devin supervisa la CI de cada capa y corrige los fallos a medida que aparecen, controlando la preparación de toda la serie en lugar de gestionar las PR una por una.
  • Cambio automático de destino — A medida que se fusiona la parte inferior de la pila, GitHub redirige las PR restantes a la rama troncal. No es necesario gestionar manualmente los rebase.

​
Trabajar con pilas

Puedes indicarle a Devin cómo gestionar las pilas en una sesión:
  • Pide a Devin que divida un cambio grande en una pila o que mantenga el trabajo en una sola PR.
  • Pide a Devin que agregue PR de seguimiento al final de una pila existente.
  • Pide a Devin que compruebe el estado de una pila: informará del estado de cada capa, la CI, la decisión de revisión y si se puede fusionar.
  • Pide a Devin que desapile: la pila se disolverá y sus PR sin fusionar volverán a ser PR independientes, sin modificar sus ramas. Las capas ya fusionadas permanecerán fusionadas.
En la vista de sesión, las PR que pertenecen a una pila muestran a qué pila pertenecen, y las pilas anunciadas aparecen antes de que existan sus PR para que puedas seguir el proceso mientras Devin crea la serie.

​
Revisar y fusionar pilas

Devin Review trata las pilas como elementos de primera clase: toda la serie se muestra de un vistazo, con el estado de preparación de cada capa, y la fusión se realiza de forma atómica de abajo hacia arriba. Consulta la sección sobre PR apiladas de la documentación de Devin Review para obtener más información.

​
Limitaciones

  • Solo GitHub.com — las pilas no están disponibles en GitHub Enterprise Server, GitLab, Bitbucket ni Azure DevOps.
  • Tamaño de la pila — una pila contiene entre 2 y 100 PR.
  • Fusión — los PR apilados no se pueden fusionar mediante el flujo de fusión habitual de GitHub; se fusionan mediante la fusión de la pila, que integra a la vez el PR seleccionado y todos los PR abiertos que están por debajo de él.