SuperAPI AI 工具集

stacked-prs

通用与其它

查看项目

更新于 10-16 04:31

技能介绍

用途:将大型功能拆解为多个小型、可独立评审且互相依赖的 PR,按顺序合并,得到更快的评审反馈和干净的历史记录。

主要能力:资料给出完整工作流,包括规划堆叠(把功能拆成逻辑块)、从 main 创建基础分支并提交第一个 PR、从上一个 PR 的分支(而非 main)继续堆叠下一个 PR、为每个 PR 撰写包含堆叠位置与依赖关系的描述,以及使用 gh pr create --base 指向上一分支。还说明如何处理基础 PR 收到反馈后对依赖 PR 逐层 git rebase 并 git push --force-with-lease,以及基础 PR 合并后用 gh pr edit 102 --base main 改变目标分支并在 main 上 rebase。附有堆叠可视化注释表格与一段名为 stack-rebase.sh 的 bash 自动化脚本,用于按顺序 rebase 整个堆叠。

使用方式:命令与流程均以 git 与 GitHub CLI 为主,例如 git checkout -b feature/auth-base、git add -p、git commit、git push -u origin、gh pr create --base main、git rebase、git push --force-with-lease、gh pr edit 102 --base main。资料还提到可安装辅助工具 gh extension install dlvhdr/gh-dash,以及第三方工具 Graphite、Stacked、git-branchless。

最佳实践:每个 PR 保持在 400 行以内、可独立评审、在描述中记录堆叠结构、用 [1/3] 等编号、未完成项使用草稿 PR、反馈后 rebase 而非合并。避免循环依赖、堆叠超过 4 至 5 层、堆叠开放超过一周、对已批准 PR 强制推送、乱序合并。

限制与不适用场景:小型功能(总计少于 300 行)、互不相关的改动、紧急热修复、单一目的重构均不建议使用堆叠。资料未提供具体工具的价格、平台或效果数据。