SuperAPI AI 工具集

stack-push

通用与其它

查看项目

更新于 10-15 17:20

技能介绍

用途:stack-push 用于发布或更新一个分支堆叠(stack)。它把 stack 中所有分支推到远端,并为每个切片(slice)创建一个 PR,每个 PR 的 base 指向其父分支,从而形成依赖链。适合在 stack-create 初始化分支拓扑、且每个切片分支至少有一个提交之后运行;也适合在向某个切片追加提交后运行,以更新已开启的 PR。

主要能力:按堆叠顺序(base 切片优先)推送分支;用 gh 检查每个分支是否已有 PR,已有则跳过,没有则以 --draft 创建;在根 PR 上发布 ## Stack 汇总评论,包含 #、Branch、PR 三列的表格。

必要用法:先列出分支,约定共享 stack/<feature-name>/ 前缀,并确认每个分支相对 base 有 ≥1 个提交;再推送分支,可使用 git push --set-upstream origin <branch>,若安装了 jj 可运行 jj git push --all;然后用 gh pr create 对每个切片创建指向父分支的 PR;最后在第一个 PR 上发布堆叠表格。开始前建议创建四个 TodoWrite 项:stack-push:branches-listed、stack-push:branches-pushed、stack-push:prs-opened、stack-push:stack-summary-posted,并按序完成。

限制与注意:尚无堆叠时应使用 sanctum:stack-create;base 已合并需要追平时使用 sanctum:stack-rebase。需要 gh CLI 已认证(gh auth status)。每个切片分支相对 base 至少有 1 个提交,0 提交的分支会被阻止推送。默认创建草稿 PR,标题和正文需手工填写后再取消草稿;可对每个切片运行 Skill(sanctum:pr-prep) 生成质量门控的描述。执行 git rebase --update-refs 后应使用 git push --force-with-lease 重新推送,不要用 --force。