SuperAPI AI 工具集

finish-branch

编程与开发

查看项目

更新于 10-15 17:17

技能介绍

用途:在开发实现完成、所有测试通过后,指导如何收尾并整合分支工作。核心原则为:验证测试 → 呈现选项 → 执行选择 → 清理。开始时需声明:“I'm using the finishing-a-development-branch skill to complete this work.”

主要流程:

  1. 验证测试:运行项目测试套件,如 npm test / cargo test / pytest / go test ./...。若失败,必须修复后才能继续,不得进入下一步。
  2. 确定基础分支:尝试 git merge-base HEAD main 或 master,或询问分支是否从 main 分出。
  3. 呈现四个选项:1) 本地合并回 <base-branch>;2) 推送并创建 Pull Request;3) 保持分支原样;4) 丢弃该工作。选项需简洁,不加解释。
  4. 执行选择: 选项1:git checkout <base-branch>、git pull、git merge <feature-branch>、验证合并后测试、git branch -d <feature-branch>,然后清理 worktree。 选项2:git push -u origin <feature-branch>,再用 gh pr create 创建 PR,然后清理 worktree。 选项3:报告保留分支与 worktree,不清理。 选项4:先确认将永久删除的分支、提交与 worktree,需输入 'discard' 确认,确认后执行 git checkout <base-branch>、git branch -D <feature-branch>,再清理 worktree。
  5. 清理 worktree:选项1、2、4 执行;检查是否在 worktree 中可用 git worktree list | grep $(git branch --show-current),如是在则用 git worktree remove <worktree-path>。选项3 保留 worktree。

限制与注意:绝不跳过测试验证、绝不在结果上未验证测试就合并、绝不无确认删除工作、绝不未经明确请求强制推送;必须始终先验证测试、恰好呈现四个选项、选项4需输入确认、仅选项1和4清理 worktree。该技能由 subagent-driven-development(第7步)和 executing-plans(第5步)调用,并与 using-git-worktrees 配合使用。