用途:在开发工作完成、测试通过后,帮助决定如何整合分支成果。核心流程为:验证测试 → 呈现选项 → 执行所选方案 → 清理。
主要能力:
- 验证测试:先运行项目测试套件(如 npm test、cargo test、pytest、go test ./...)。若测试失败,必须修复后才能继续,不得进入下一步。
- 确定基础分支:用 git merge-base HEAD main 或 master 判断,或向用户确认分支来源。
- 呈现四个固定选项:本地合并回基础分支、推送并创建 Pull Request、保持分支原样、丢弃该工作。
- 执行所选方案:
- 本地合并:git checkout <base-branch>、git pull、git merge <feature-branch>,合并后再次验证测试,通过则 git branch -d <feature-branch>。
- 创建 PR:git push -u origin <feature-branch>,再用 gh pr create 创建,包含 Summary 与 Test Plan。
- 保持原样:报告分支与 worktree 位置,不清理 worktree。
- 丢弃:需用户输入 discard 确认,然后 git checkout <base-branch> 与 git branch -D <feature-branch>。
- 清理 worktree:仅对选项 1、2、4 执行,用 git worktree list 检查后 git worktree remove <worktree-path>;选项 3 保留。
使用方式:在实现完成、测试通过后调用该技能,开始时声明正在使用它。
适用场景:功能分支收尾、需要决定合并或提 PR 时;常被 subagent-driven-development 与 executing-plans 调用,并与 using-git-worktrees 配合。
限制与注意:不得在测试失败时继续;不得未经确认删除工作;不得在未明确要求时强制推送;选项 2、3 不清理 worktree;丢弃必须输入 discard 确认。