finishing-a-development-branch

用途：在实现完成、测试通过后，帮助决定如何整合开发分支的工作。核心原则是“验证测试 → 呈现选项 → 执行选择 → 清理”。开始时需声明正在使用该技能完成工作。\n\n主要能力与流程：\n第一步验证测试。先运行项目测试套件（如 bin/rails test，或其他项目的 npm test / cargo test / pytest / go test ./...）。若测试失败，列出失败项并停止，不允许继续合并或创建 PR。\n第二步确定基分支。可通过 git merge-base HEAD main 或 master 探测，或向用户确认分支来源。\n第三步呈现四个固定选项：1) 本地合并回基分支；2) 推送并创建 Pull Request；3) 保留分支原样，稍后处理；4) 丢弃该工作。选项需简洁，不额外解释。\n第四步执行选择。选 1：切换到基分支、拉取最新、合并功能分支、在合并结果上验证测试，通过后删除功能分支。选 2：推送分支并用 gh pr create 创建 PR，包含变更摘要与测试计划。选 3：报告保留分支与工作树位置，不清理。选 4：先列出将永久删除的分支、提交与工作树，要求输入“discard”确认后再删除。\n第五步清理工作树。仅选项 1、2、4 需要检查并移除工作树；选项 3 保留工作树。\n\n适用场景：开发任务或计划执行完毕后的收尾阶段，常被 subagent-driven-development 第 7 步与 executing-plans 第 5 步调用，并与 using-git-worktrees 配合清理其创建的工作树。\n\n限制与注意事项：不得在测试失败时继续；不得在未验证合并结果测试的情况下合并；不得未经确认删除工作；不得未经明确请求强制推送；必须始终呈现恰好四个选项，丢弃需输入确认。