用途
该技能用于在开发实现完成、所有测试通过后,指导完成开发工作的收尾流程,帮助使用者决定如何整合已完成的代码。其核心原则为:验证测试 → 给出选项 → 执行选择 → 清理。开始时应声明:“I'm using the finishing-a-development-branch skill to complete this work.”
主要能力与流程
第 1 步:验证测试
在给出选项前,先运行项目测试套件(如 npm test / cargo test / pytest / go test ./...)验证测试通过。若测试失败,则提示测试失败及失败数量,并展示失败信息,要求修复后才能继续;此时停止,不进入第 2 步。测试通过后继续。
第 2 步:确定基础分支
通过 git merge-base HEAD main 或 git merge-base HEAD master 尝试确定基础分支,或直接询问当前分支是否从 main 分叉。
第 3 步:给出选项
只给出以下四个选项,不添加额外解释,保持简洁:本地合并回基础分支、推送并创建 Pull Request、保留分支原样(稍后处理)、丢弃此工作。
第 4 步:执行选择
- 选项 1(本地合并):切换到基础分支,拉取最新代码,合并特性分支,在合并结果上验证测试,测试通过后删除特性分支,然后执行第 5 步清理 worktree。
- 选项 2(推送并创建 PR):推送分支,使用 gh pr create 创建 PR(含 Summary 与 Test Plan),然后执行第 5 步清理 worktree。
- 选项 3(保留原样):报告保留分支及 worktree 位置,不清理 worktree。
- 选项 4(丢弃):先确认,列出将永久删除的分支名、所有提交列表、worktree 路径,要求输入“discard”确认;确认后切换基础分支并强制删除特性分支,然后执行第 5 步清理 worktree。
第 5 步:清理 worktree
对于选项 1、2、4,检查是否在 worktree 中(git worktree list 配合当前分支),若是则移除该 worktree。选项 3 保留 worktree。
快速参考
选项 1 本地合并:合并 ✓,不推送,不保留 worktree,清理分支 ✓。 选项 2 创建 PR:不合并,推送 ✓,保留 worktree ✓,不清理分支。 选项 3 保留原样:不合并,不推送,保留 worktree ✓,不清理分支。 选项 4 丢弃:不合并,不推送,不保留 worktree,强制清理分支 ✓。
常见错误与规避
- 跳过测试验证:会导致合并坏代码、创建失败 PR;应先验证测试再给出选项。
- 开放式提问:应只给出四个结构化选项。
- 自动清理 worktree:可能仍需要该 worktree(选项 2、3);仅对选项 1 和 4 清理。
- 丢弃无确认:可能误删工作;应要求键入“discard”确认。
红线
绝不:在测试失败时继续、未在合并结果上验证测试就合并、未经确认删除工作、未明确要求就强制推送。 始终:给出选项前验证测试、只给出四个选项、对选项 4 要求键入确认、仅对选项 1 与 4 清理 worktree。
集成关系
由 subagent-driven-development(第 7 步,所有任务完成后)和 executing-plans(第 5 步,所有批次完成后)调用。与 using-git-worktrees 配对使用,负责清理该技能创建的 worktree。