SuperAPI AI 工具集

stacked-prs

编程与开发

查看项目

更新于 10-15 17:28

技能介绍

用途:该技能用于创建和管理堆叠式(依赖型)拉取请求,即每个 PR 建立在前一个 PR 之上,适合需要逻辑拆分和并行审查的大型复杂功能。

使用条件:仅在用户明确要求“stacked PRs”或“dependent PRs”、功能需要拆分为有清晰依赖关系的多个阶段、且用户熟悉 rebase 工作流时使用。默认应优先使用基于主干的普通 PR;功能相互独立、简单修复或增强、多智能体并行工作时不应使用。

分支命名:采用顺序编号体现依赖,例如 feature/001-base-authentication、feature/002-user-profile、feature/003-admin-panel,也可用 auth/01-foundation 等模式。

创建流程:基础 PR 从 main 创建分支并推送;后续 PR 必须基于前一个功能分支而非 main,例如 git checkout feature/001-base-auth 后再 git checkout -b feature/002-user-profile。PR 标题建议标注 [1/3] 等序号,并注明依赖的 PR 编号。描述模板包含本 PR 说明、依赖项、堆栈总览和审查指引(可用 git diff feature/001-base-auth...feature/002-user-profile 只查看当前 PR 变更)。

重基管理:当基础 PR 更新后,依次对依赖分支执行 git rebase 并推送,必须使用 git push --force-with-lease 而非 --force。合并策略可选顺序合并(合并后将下一个 PR 的 base 改为 main)或保持堆栈至结束再逐个重基到 main。

常见错误:所有分支都从 main 创建会使 PR 相互独立而非堆叠;正确做法是每个分支基于前一个功能分支创建。

验证清单:确认用户明确要求堆叠 PR、功能有清晰阶段、各阶段存在依赖、用户理解 rebase 工作流、分支使用顺序编号、每个分支基于正确的基础分支、PR 描述包含依赖信息和堆栈总览。

相关技能包括 git-worktrees、git-workflow 和 code-review。