SuperAPI AI 工具集

split-prs

部署与运维

查看项目

更新于 10-16 03:11

技能介绍

用途:把一堆混杂的改动整理成 gh-stack 形式的可部署切片,每个切片都能单独安全合并与发布,并支持按提交逐条审查。允许自由重写历史(重排、fixup、squash),但强调粒度宜粗,只有在提升审查清晰度或降低部署风险时才拆分。

主要能力:先勘察主干、diff、提交列表与意图来源;再提出最粗的可部署切片方案,列出标题、范围、可部署理由与计划提交,并用 Mermaid 图展示 trunk→bottom→…→top;获批后自底向上重建历史,用非交互式 gh stack 创建命名分支、提交、提交 PR 并查看结果;最后按 prepare-for-review 与 TEMPLATE.md 为每个 PR 准备标题与正文。

必要用法:需要 docs/agents/commit-style.md 与 gh stack 扩展(gh extension install github/gh-stack);缺少提交风格时运行 /setup-formsg-ai-skills。可部署性与粒度规则见 DEPLOYABLE.md,PR 标题与正文语气继承 TEMPLATE.md。关键命令包括 gh stack init --base <trunk> <bottom-branch>、gh stack add <next-branch>、gh stack submit --auto、gh stack view --json。

限制:重写历史、创建分支、推送或开 PR 前必须先提出方案并等待批准;先做快照(git stash create → refs/backup/pre-split-<timestamp>)。中途修复需下移到对应分支提交,再 gh stack rebase --upstack。PR 已由 submit 创建,准备阶段应使用 gh pr edit 而非新建。其余细节资料未提供。