用途:在开发工作实现完成、所有测试通过后,指导如何整合该分支的工作。核心原则为验证测试→给出选项→执行所选→清理。开始时应声明使用该技能。
流程:第一步验证测试,需运行项目测试套件(如 npm test、cargo test、pytest、go test ./...)。若测试失败,必须修复后才能继续,不得进入第二步。测试通过后进入第二步确定基础分支,可用 git merge-base HEAD main 或 HEAD master 判断,或向用户确认分支来源。
第三步给出恰好四个选项:1. 本地合并回基础分支;2. 推送并创建 Pull Request / Merge Request(GitHub/Forgejo;本地 tk 仅推送);3. 保持分支现状;4. 丢弃此工作。选项保持简洁,不加解释。
第四步执行所选。本地合并:切换到基础分支、拉取最新、合并特性分支、在合并结果上验证测试,通过后删除分支。推送创建 PR/MR:推送分支(git push -u origin ),GitHub 用 gh pr create 并提供摘要与测试计划,Forgejo 用 tea pr create 或 API,本地 tk 仅推送并加备注。保持现状:报告保留分支与 worktree,不清理。丢弃:先确认将永久删除的分支、提交与 worktree,要求输入 discard 确认后执行 git checkout 基础分支与 git branch -D 特性分支。
第五步清理 worktree:选项 1、2、4 时若处于 worktree 则执行 git worktree remove;选项 3 保留 worktree。
限制与注意事项:绝不在测试失败时继续,不在未验证合并结果测试前合并,不在未经确认时删除工作,不擅自强制推送。仅选项 1 与 4 清理 worktree。该技能由 teams-driven-development、executing-plans 调用,并与 using-git-worktrees 配合。