用途:在开发工作实现完成、所有测试通过时,指导如何整合这段工作。核心流程为:验证测试 → 检测环境 → 呈现实项 → 执行选择 → 清理。开始时应声明:“I'm using the finishing-a-development-branch skill to complete this work.”
主要能力与用法: 一、验证测试。先运行项目测试套件,例如 npm test / cargo test / pytest / go test ./...。若测试失败,须先修复,停止流程,不得进入下一步;通过后才继续。 二、检测环境。用 git rev-parse --git-dir 与 --git-common-dir 判断工作区状态:普通仓库显示标准 4 个选项且无 worktree 需清理;命名分支 worktree 同样显示 4 个选项,清理依据来源判断;分离 HEAD 仅显示 3 个选项(无合并),且不做清理。 三、确定基线分支。可用 git merge-base HEAD main 或 master,或向用户确认分支来源。 四、呈现选项。普通仓库与命名分支 worktree 给出 4 个选项:本地合并回基线分支、推送并创建 PR、保持分支原样、丢弃此工作。分离 HEAD 给出 3 个选项:推送为新分支并创建 PR、保持原样、丢弃。选项保持简洁,不加解释。 五、执行选择。选项 1:先切回主仓库根目录,git checkout 基线分支、git pull、git merge 功能分支,在合并结果上再次验证测试,成功后再清理 worktree 并删除分支(git branch -d)。选项 2:git push -u origin 分支,并用 gh pr create 创建 PR,不清理 worktree,以便按 PR 反馈迭代。选项 3:报告保留分支与 worktree 路径,不清理。选项 4:先列出将永久删除的分支、提交与 worktree 路径,要求输入 discard 确认,确认后切回主仓库根目录,清理 worktree 并 git branch -D 强制删除分支。 六、清理。仅选项 1 和 4 执行。若 worktree 位于 .worktrees/、worktrees/ 或 ~/.config/superpowers/worktrees/ 下,则执行 git worktree remove 与 git worktree prune;否则视为宿主环境所有,不删除,若平台提供工作区退出工具则使用它。
适用场景:功能开发完成后决定如何整合代码、需要标准化收尾流程的场景。
限制与注意事项:不得在测试失败时继续,不得在未验证合并结果的情况下合并,不得未经确认删除工作,不得未经明确请求强制推送,不得在未确认合并成功前移除 worktree,不得清理非自己创建的 worktree,且移除 worktree 前必须切换到主仓库根目录。