堆叠PR分支管理
基于GitHub CLI堆叠扩展将多层依赖需求按线性分支拆分提交,实现隔离代码变更并批量同步与合并PR。
功能与用途
该功能基于 GitHub 官方拓展 gh-stack,面向中大型特性开发场景,解决单次 Pull Request 代码量过大难以评审的问题。它允许开发者从主分支起依序创建多层线性依赖分支,各层仅包含独立关注点的改动,并能自动推送到远端创建层级 Draft/Open PR。支持在底层分支变更后一键向顶层分支 rebase 同步、多分支整体合并,并提供安全的无界面非交互式 CLI 参数方案,保障智能体与脚本环境下的稳定调用。
适用场景
- 大型功能模块化拆分评审:将包含多个依赖关注点的大型需求拆分为链式分支,使各层 PR 拥有小而专注的评审范围。
- 底层修改后的全栈变基同步:在修改底层通用逻辑后,一键向顶层依赖分支级联 rebase 同步并批量更新 PR 状态。
- 链式 PR 批量一并合并:在完成全栈链路评审后,指定目标 PR 或栈编号批量完成自动化合入,无需手动逐个点击。
适用人群
- 负责复杂系统架构改造或大型特性开发的全栈/后端研发工程师
- 对代码审查粒度有严格要求、推崇小步快跑(Stacked PR)工作流的开发团队
- 需要通过命令行脚本或自动化智能体执行批量分支维护的 DevOps 人员
使用步骤
- 在开发新功能前使用 gh stack init <底层分支名> 创建初始分支栈
- 完成底层代码提交后,使用 gh stack add <上层分支名> 叠加依赖分支并编写上层业务
- 调用 gh stack submit --auto 将堆叠链完整推送至 GitHub 并自动生成关联 PR
- 若底层修改,利用 gh stack down 切换回改动层提交,运行 gh stack rebase --upstack 传递改动后 push
- 审查通过后,使用 gh stack merge <PR编号> --yes 执行自底向上的全链路自动化合并
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 进阶
- 版本
- main
- 最近更新
- 2026-09-23
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
>
使用前准备
- 本地已安装 GitHub CLI(gh)及 Git,并完成 gh auth 登录认证
- 已安装 gh-stack 扩展(gh extension install github/gh-stack)
- 配置 git rerere.enabled 为 true,并在多远程仓库环境下指定 remote.pushDefault 为 origin
依赖与权限
- 读取用户主动提供的内容