用途:当开发实现完成、测试全部通过、需要决定如何整合工作时,用该技能规范地收尾开发分支。核心流程为:验证测试 → 展示选项 → 执行选择 → 清理。开始时需声明正在使用 finishing-a-development-branch 技能。
主要能力与用法:第一步验证测试,运行项目测试套件,如 npm test、cargo test、pytest、go test ./...;测试失败则停止,不得进入下一步。第二步确定基础分支,可用 git merge-base HEAD main 或 git merge-base HEAD master,或向用户确认。第三步展示且仅展示四个选项:1) 本地合并回基础分支;2) 推送并创建 Pull Request;3) 保持分支原样;4) 丢弃此工作。第四步按选择执行:本地合并使用 git checkout、git pull、git merge,并在合并结果上重跑测试,通过后 git branch -d;创建 PR 使用 git push -u origin 与 gh pr create,并提供 Summary 与 Test Plan 模板;保留则报告分支与工作树位置,不清理;丢弃需输入 discard 确认,再 git checkout 与 git branch -D。第五步对选项 1、2、4 清理工作树,用 git worktree list 检查后 git worktree remove;选项 3 保留工作树。
适用场景:实现完成、测试通过、需要整合或结束分支时。限制与注意:不得在测试失败时继续,不得在未验证合并结果测试的情况下合并,不得未经确认删除工作,不得在无明确要求时强制推送;应始终先验证测试、只展示四个结构化选项、对丢弃要求键入确认、仅对选项 1 与 4 清理工作树。该技能可与 subagent-driven-development、executing-plans 搭配,并由 using-git-worktrees 配合清理工作树。