gh-stack
GitHub CLI扩展，用于管理堆叠式分支和拉取请求。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：gh-stack。 它的用途是：GitHub CLI扩展，用于管理堆叠式分支和拉取请求。 完整的 Skill 内容见：https://321skill.com/skills/gh-stack/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我在当前项目里初始化一个gh-stack，第一层分支叫‘用户认证’，然后在其基础上添加‘API端点’和‘前端界面’两个分支。” 它会引导你或直接执行 `gh stack init 用户认证 API端点 前端界面` 来创建堆叠。接着，当你完成‘用户认证’层的代码后，
对AI说：“提交当前堆叠的所有分支并创建PR。” 它会执行 `gh stack push` 和 `gh stack submit`，自动创建三个相互链接的PR。
介绍
gh-stack 是一款 GitHub CLI 扩展，旨在解决大型代码变更难以拆分和评审的痛点。它将一个复杂的改动分解为一系列相互依赖、易于评审的小型拉取请求（PR），形成一条清晰的“堆叠”链。
使用时，开发者通过 gh stack init 初始化一个堆叠，然后使用 gh stack add 在顶部添加新的分支层。每个分支专注于一个独立的子任务。gh stack push 推送所有分支，gh stack submit 则会一键创建所有相互关联的 PR，每个 PR 的基准分支（base）自动设置为堆叠中的下一层，确保评审者只看到当前层的差异。
该工具非常适合需要处理复杂功能开发、重构或大规模代码修改的团队开发者，尤其是那些遵循“小步快跑”、频繁提交和代码评审流程的团队。它降低了管理多个依赖分支的心智负担。
与传统的多分支管理或手动创建依赖 PR 相比，gh-stack 的核心区别在于其“堆叠”的元数据管理和自动化工作流。它并非简单地创建多个分支，而是维护分支间的依赖关系，并在 rebase、提交等环节自动保持整个堆叠结构的一致性和正确性，这是手动操作或普通脚本难以实现的。
核心特点
gh-stack 的核心在于其“堆叠”的元数据管理和全链路自动化。它不仅能创建相互关联的分支和PR，更重要的是能自动维护整个堆叠在rebase、更新时的依赖关系，确保每个PR的基准分支始终正确指向堆叠中的下一层，这是手动操作极易出错且繁琐的部分。
注意事项
该功能目前处于私有预览阶段，需要申请加入等待列表并获得仓库授权后才能使用。
常见问题
gh-stack 和普通的多分支开发有什么区别？
gh-stack 维护分支间的“堆叠”依赖关系，能自动设置PR基准分支、同步rebase，而普通多分支是独立、平级的，依赖关系需手动维护。
使用 gh-stack 需要什么前提条件？
需要安装 GitHub CLI (gh) v2.0+，并且目标仓库已启用 Stacked PRs 预览功能（需申请）。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/gh-stack/raw/index.md 读取 gh-stack 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/gh-stack/raw/index.md（查看排版版本）