SuperAPI AI 工具集

pr-stack

通用与其它

查看项目

更新于 10-16 03:16

技能介绍

用途:管理堆叠式 PR,即一串小分支各自开一个 PR,并在 rebase 后保持顺序、成组推送。该技能不模拟堆叠,而是检测用户已安装的堆叠工具并驱动它。

主要能力:支持三种工具——Graphite(gt,第三方 CLI,需账户,元数据在 .git/.graphite_repo_config)、git-town(第三方 CLI,无需账户,支持多平台,分支血缘存于本地 git config)、GitHub gh stack(官方 gh 扩展,2026-05 为私有预览,仓库需白名单)。技能会运行探测命令判断哪个工具已安装且已配置,优先选 gt,其次 git town,最后 gh stack;若均不可用则停止并提示安装方式,不擅自用普通 git 模拟。

使用方式:每次调用先运行探测(如 command -v gt、检查 .graphite_repo_config、gh extension list 中是否有 github/gh-stack、git config --local --get git-town.main-branch)。选定工具后按其参考文档操作。PR 合并后需运行对应 sync 命令(gt sync 后 gt submit --stack;gh stack sync;git town sync --stack),冲突时用工具自身的 continue/abort,而非裸 git rebase。

适用场景:需要将大改动拆成多个可独立审查的小 PR,并保持分支链同步的团队。

限制:gh stack 需仓库白名单,远程操作失败返回退出码 4;工具命令随版本变化,应以各工具参考为准;未安装任何工具时无法使用。