用途:在开发实现完成、测试通过后,帮助决定如何整合分支工作。核心流程为:验证测试 → 呈现选项 → 执行选择 → 清理。开始时需声明正在使用该技能。
主要能力与用法:
- 验证测试:先运行项目测试套件(如 npm test、cargo test、pytest、go test ./...)。若测试失败,必须停止,不得进入下一步,也不能合并或创建 PR。
- 确定基础分支:可用 git merge-base HEAD main 或 git merge-base HEAD master 判断,或向用户确认分支来源。
- 呈现选项:只给出四个选项——本地合并回基础分支、推送并创建 Pull Request、保持分支原样、丢弃该工作。选项保持简洁,不加解释。
- 执行选择:
- 本地合并:切换基础分支、拉取最新、合并特性分支、在合并结果上再次验证测试,通过后删除特性分支。
- 推送并创建 PR:git push -u origin <feature-branch>,再用 gh pr create 创建 PR,正文包含变更摘要与测试计划。
- 保持原样:报告保留分支与工作树位置,不清理工作树。
- 丢弃:先列出将永久删除的分支、提交与工作树路径,要求输入 discard 确认,确认后切换基础分支并 git branch -D 删除。
- 清理工作树:仅对选项 1、2、4 执行;用 git worktree list 检查是否处于工作树,若是则 git worktree remove <worktree-path>。选项 3 保留工作树。
适用场景:由 subagent-driven-development(第 7 步)或 executing-plans(第 5 步)在任务或批次完成后调用,并与 using-git-worktrees 配合清理其创建的工作树。
限制与注意:不得在测试失败时继续;不得在未验证合并结果测试的情况下合并;不得未经确认删除工作;不得在未明确要求时强制推送。常见错误包括跳过测试验证、使用开放式提问、自动清理工作树、丢弃时缺少确认。