stack-workflows

用途：在 GitButler 中组织堆叠分支，把有顺序依赖的工作（如重构→API→前端）拆成可独立评审的层级，也支持探索式编码后的事后整理。不适用于相互独立的并行功能（应使用 virtual branches），也不适用于使用 Graphite 堆叠的项目。\n\n主要能力：创建堆叠分支、提交、堆叠层级导航、堆叠内压缩、在层级间移动提交、拆分分支、事后重新组织堆叠，以及为堆叠准备 PR。\n\n核心用法：用 but branch new <name> 建基础分支，子分支加 --anchor 指定父分支（短写 -a），例如 but branch new child-feature --anchor base-feature，形成 base ← child ← grandchild。用 but commit <branch> -m "..." 提交，用 but log 查看结构，用 but rub <sha> <branch> 移动或调整提交，用 but snapshot 在重组前快照。PR 需借助 GitHub CLI，先 git push -u origin <branch>，再 gh pr create --base <父分支> --head <子分支>。\n\n适用场景：顺序依赖的功能、大功能拆分为可评审块、细粒度评审、事后整理。\n\n限制与注意：GitButler CLI 无原生 PR 提交，需用 gh；合并须自底向上、按顺序进行，不得跳过层级；不要堆叠互不相关的功能；不建议无充分理由建 5 层以上深栈；建依赖分支时不要漏掉 anchor，缺失会导致堆叠不出现在 but log；提交放错层级可用 but rub <sha> <目标分支> 修正。建议每层保持 100–250 行代码以便评审，重组后删除空分支。版本控制、合并到 main、多智能体协调等关联技能及 GitButler 官方文档细节，资料中未完整提供。