用途:在开发实现完成、测试通过后,引导用户决定如何整合分支工作,避免开放式提问带来的歧义。
主要能力:先运行项目测试套件(如 npm test、cargo test、pytest、go test ./...),测试失败则停止并提示必须先修复;随后通过 git rev-parse --git-dir 与 --git-common-dir 检测工作区状态,区分普通仓库、命名分支 worktree 与 detached HEAD,并据此给出不同菜单。普通仓库和命名分支 worktree 提供四个选项:本地合并回基分支、推送并创建 PR、保持现状、丢弃工作;detached HEAD 只提供三个选项(无本地合并)。
使用方式:技能开始时声明正在使用该技能。选择本地合并时,先切到主仓库根目录,执行 git checkout、git pull、git merge,并在合并结果上再次验证测试,成功后再清理 worktree 并执行 git branch -d。选择创建 PR 时执行 git push -u origin 与 gh pr create,且不清理 worktree,以便根据 PR 反馈继续迭代。选择保持现状则保留分支与 worktree。选择丢弃需输入 discard 确认,随后强制删除分支。
清理规则:仅选项 1 和 4 执行清理;仅当 worktree 位于 .worktrees/、worktrees/ 或 ~/.config/superpowers/worktrees/ 下才由本技能负责移除,移除前必须先 cd 到主仓库根目录,移除后运行 git worktree prune。宿主环境管理的 worktree 不应删除。
限制与注意:不得在测试失败时继续;不得在未验证合并结果测试的情况下合并;不得未经确认删除工作;不得在未明确要求时强制推送;不得在确认合并成功前移除 worktree;不得清理非本技能创建的 worktree。