Por qué sus PRs son un cuello de botella
Los Mega-PRs paralizan la velocidad de desarrollo. Revisar cientos, a menudo miles, de líneas de código se convierte en una tarea imposible, lo que lleva a errores pasados por alto, revisiones superficiales y una grave fatiga de revisión. Estos cambios monolíticos impiden que otros desarrolladores integren su trabajo, creando cuellos de botella generalizados.
Consecuencia: escalada de conflictos de fusión, ramas de código que quedan obsoletas rápidamente y lanzamientos drásticamente retrasados. Este ciclo ineficiente desperdicia innumerables horas de ingeniería, introduce un riesgo significativo en la base de código y frustra a los equipos de desarrollo con su complejidad inherente.
GitHub ahora ofrece Stacked PRs, una respuesta oficial y nativa de la plataforma a este problema persistente. Esta robusta funcionalidad va más allá de las soluciones alternativas de la comunidad, integrando una potente gestión de dependencias directamente en su flujo de trabajo.
El concepto central es simple: dividir los cambios de código grandes en una cadena de pull requests más pequeños y dependientes. Cada PR se construye directamente sobre el anterior, permitiendo la revisión, aprobación y fusión independientes sin bloquear toda la funcionalidad.
Ilustre esta cadena de dependencia: su PR fundamental inicial apunta a main, por ejemplo, una migración crítica del esquema de base de datos. Luego, un segundo PR apunta a ese primer PR, implementando nuevas rutas de API que dependen del esquema actualizado. Finalmente, un tercer PR apunta al segundo PR, añadiendo componentes de interfaz de usuario que consumen la nueva API. Esto crea una progresión clara, lógica y manejable para características complejas.
Su nuevo flujo de trabajo: Apilar, Añadir, Enviar
Implemente stacked PRs utilizando la GitHub CLI para un flujo de trabajo optimizado y eficiente. Inicie su nueva pila con gh stack init [branch-name]. Este comando establece su rama fundamental, basándola automáticamente en la rama predeterminada de su repositorio, normalmente main. Esto asegura que sus cambios de nivel más bajo estén listos primero.
Progrese en su desarrollo de forma incremental añadiendo más cambios. Utilice gh stack add [branch-name] para crear una nueva rama que se base automáticamente en la rama anterior de su pila. Esto establece una cadena de dependencia clara, asegurando que cada cambio posterior se construya lógicamente sobre el anterior, desde los tipos fundamentales hasta las rutas de API.
Fundamentalmente, las operaciones estándar de Git persisten bajo esta conveniencia de la CLI. Cada comando gh stack add crea finalmente una nueva rama de Git, y usted conserva la flexibilidad de incluir múltiples commits dentro de cualquier rama individual en su pila. Esto proporciona un desarrollo estructurado sin sacrificar el control granular sobre el historial de commits.
Cuando todos los cambios se completan en toda su pila, consolide sus esfuerzos con un solo comando: gh stack submit. Esto envía cada rama de su pila a GitHub simultáneamente, generando pull requests individuales para cada una. GitHub luego los renderiza como un stacked PR cohesivo en la interfaz de usuario, simplificando la revisión.
Aunque la GitHub CLI ofrece una potente automatización y conveniencia, no es un requisito estricto. Los desarrolladores aún pueden construir pilas manualmente asegurándose de que cada pull request apunte explícitamente a la rama base precedente correcta. GitHub detecta y visualiza inteligentemente estas dependencias, incluso sin la orquestación de la CLI, proporcionando los mismos beneficios de interfaz y experiencia de revisión.
Más allá de la CLI: Stacks en el mundo real
GitHub mejora los stacked PRs con soporte de interfaz de usuario de primera clase. Observe el icono de pila distintivo que ahora aparece en la página de la lista de pull requests, señalando instantáneamente que un PR es parte de una cadena de dependencias más grande. Este indicador visual agiliza la identificación y gestión del trabajo interconectado, mejorando la visibilidad general del proyecto.
Sumérjase en cualquier PR dentro de una pila para aprovechar la stack view dedicada. Esta potente interfaz visualiza toda la cadena de dependencias, mapeando claramente la posición de cada PR, su rama de destino y su estado de revisión actual. Obtendrá claridad inmediata sobre conjuntos de funciones complejos, comprendiendo las dependencias y el progreso de un vistazo. Para obtener más detalles fundamentales sobre cómo trabajar con pull requests y sus nuevas capacidades de apilamiento, consulte About stacked pull requests - GitHub Docs.
La verdadera eficiencia llega con el botón Merge stack. Una vez que todos los PR individuales en una pila obtienen la aprobación, un solo clic fusiona toda la cadena aprobada en la rama principal. GitHub ejecuta automáticamente la fusión secuencial, manejando todos los pasos intermedios como el rebasing y las actualizaciones de rama. Esta operación atómica garantiza una fusión limpia e integrada sin intervención manual, acelerando su pipeline de entrega y minimizando los conflictos de fusión.
¿Te está gustando? Recibe uno así en tu bandeja cada mañana.
un correo al día · date de baja en dos clics · sin rastreadores de terceros
Las pilas no son solo para humanos
Los diffs más pequeños y enfocados desbloquean inmediatamente a los revisores, acelerando drásticamente los ciclos de revisión. La reducción del cambio de contexto y la carga cognitiva significa aprobaciones más rápidas y comentarios de mayor calidad. Los equipos ahora iteran más rápido, desplegando funciones con una eficiencia sin precedentes.
Más allá de los flujos de trabajo humanos, los Stacked PRs desbloquean un futuro poderoso para la IA. Los agentes de IA ahora pueden enviar funciones complejas y de varias partes como pull requests estructurados y dependientes. Esto desglosa el código generado por IA monolítico en fragmentos manejables y revisables. En lugar de un único volcado de código masivo, los agentes generan una cadena de dependencias revisable por humanos, proporcionando un camino claro y auditable para integrar contribuciones de IA sofisticadas.
Esta función es más que una optimización del flujo de trabajo; representa un cambio fundamental en las prácticas de desarrollo colaborativo. Redefine fundamentalmente cómo los equipos abordan la entrega de funciones complejas y el trabajo concurrente. La respuesta de los desarrolladores ha sido abrumadoramente positiva, validando la visión de GitHub para la evolución del desarrollo central. Espere aumentos inmediatos y significativos en la velocidad del equipo y en el rendimiento general del proyecto.
Preguntas frecuentes
¿Qué son los GitHub Stacked PRs?
Una función nativa de GitHub para crear una cadena de pull requests más pequeños y dependientes que pueden revisarse de forma independiente y fusionarse como una sola unidad.
¿Necesito el GitHub CLI para usar Stacked PRs?
No. El CLI (con comandos gh stack) agiliza el proceso, pero puede crear una pila manualmente dirigiendo los PR subsiguientes a la rama del PR anterior. GitHub detecta automáticamente la pila.
¿En qué se diferencia una pila de simplemente encadenar PRs?
Aunque el concepto de Git es similar, GitHub ahora reconoce oficialmente estas cadenas como una 'pila' (stack). Esto proporciona una interfaz de usuario dedicada para gestionar, visualizar y fusionar toda la pila a la vez, lo que anteriormente era un proceso manual.
¿Puedo trabajar en otras ramas mientras tengo una pila activa?
Sí. Una pila es una capa de gestión sobre Git. Puede usar comandos estándar de Git como git checkout para cambiar a ramas no relacionadas y luego volver a una rama dentro de su pila más tarde sin problemas.