用途
在开发工作完成、测试全部通过时,帮助用户决定如何把当前分支上的工作整合回主线。它通过固定流程把“收尾”这件事规范化,避免在测试失败时误合并、在需要继续迭代 PR 时误删工作树、或未经确认就丢弃代码。
核心流程
核心原则为:验证测试 → 检测环境 → 呈现选项 → 执行选择 → 清理。技能启动时会声明正在使用该技能完成收尾工作。
第一步:验证测试
在给出选项前先运行项目测试命令(如 npm test、cargo test、pytest、go test ./...)。若测试失败,展示失败信息并停止流程,明确不能继续合并或创建 PR;只有测试通过才进入下一步。
第二步:检测环境
通过比较 git rev-parse --git-dir 与 --git-common-dir 判断工作区状态:普通仓库显示标准四选项;命名分支工作树同样显示四选项,但清理按来源判断;分离 HEAD 时只显示三个选项(不含合并)。
第三步:确定基分支
用 git merge-base HEAD main 或 master 探测,或直接向用户确认该分支从哪个基分支分出。
第四步:呈现选项
普通仓库与命名分支工作树提供四个选项:
- 本地合并回基分支
- 推送并创建 Pull Request
- 保持分支原样(稍后自行处理)
- 丢弃本次工作 分离 HEAD 时提供三个选项:推送为新分支并创建 PR、保持原样、丢弃工作。选项保持简洁,不附加解释。
第五步:执行选择
- 本地合并:先切换到主仓库根目录,检出基分支、拉取、合并特性分支,在合并结果上再次运行测试,成功后才清理工作树并删除分支(git branch -d)。
- 创建 PR:执行 git push -u origin <feature-branch>,不清理工作树,因为用户仍需基于 PR 意见迭代。
- 保持原样:报告分支与工作树位置,不清理。
- 丢弃:先列出将永久删除的分支、提交列表和工作树路径,要求用户输入 discard 确认后才在主仓库根目录执行清理并强制删除分支(git branch -D)。
第六步:清理工作区
仅针对选项 1 和 4 执行。普通仓库无需清理;工作树位于 .worktrees/ 或 worktrees/ 下时视为本技能创建,负责移除并执行 git worktree prune;其他宿主环境管理的工位不删除,如有平台提供的退出工作区工具则使用之,否则保留原状。
适用场景
适用于功能开发已实现且测试通过、需要决定合并或提 PR 的收尾时刻,尤其适合使用 Git worktree 并行开发的场景。
限制与约束
- 测试未通过时绝不继续。
- 合并后必须复测,未确认合并成功前不得移除工作树。
- 丢弃工作必须获得输入 discard 的明确确认。
- 不得在未明确要求时强制推送。
- 只清理来源属于本技能的工作树(.worktrees/ 或 worktrees/ 下),不清理宿主管理的工位。
- 移除工作树前必须先切换到主仓库根目录,移除后运行 git worktree prune。
- 删除分支应在移除工作树之后进行,避免因工作树仍引用分支而删除失败。
常见错误
跳过测试验证、用开放式问题代替结构化选项、为选项 2 清理工作树、先删分支后移工作树、在被移除的工作树内部执行移除命令、清理非自建工作树、丢弃前不做确认。