SuperAPI AI 工具集

finishing-a-development-branch

编程与开发

查看项目

更新于 10-16 06:13

技能介绍

用途:在开发工作完成、测试通过后,帮助决定如何整合分支成果。核心流程为:验证测试 → 呈现选项 → 执行所选方案 → 清理。

主要能力:

  1. 验证测试:先运行项目测试套件(如 npm test、cargo test、pytest、go test ./...)。若测试失败,必须修复后才能继续,不得进入下一步。
  2. 确定基础分支:用 git merge-base HEAD main 或 master 判断,或向用户确认分支来源。
  3. 呈现四个固定选项:本地合并回基础分支、推送并创建 Pull Request、保持分支原样、丢弃该工作。
  4. 执行所选方案:
    • 本地合并:git checkout <base-branch>、git pull、git merge <feature-branch>,合并后再次验证测试,通过则 git branch -d <feature-branch>。
    • 创建 PR:git push -u origin <feature-branch>,再用 gh pr create 创建,包含 Summary 与 Test Plan。
    • 保持原样:报告分支与 worktree 位置,不清理 worktree。
    • 丢弃:需用户输入 discard 确认,然后 git checkout <base-branch> 与 git branch -D <feature-branch>。
  5. 清理 worktree:仅对选项 1、2、4 执行,用 git worktree list 检查后 git worktree remove <worktree-path>;选项 3 保留。

使用方式:在实现完成、测试通过后调用该技能,开始时声明正在使用它。

适用场景:功能分支收尾、需要决定合并或提 PR 时;常被 subagent-driven-development 与 executing-plans 调用,并与 using-git-worktrees 配合。

限制与注意:不得在测试失败时继续;不得未经确认删除工作;不得在未明确要求时强制推送;选项 2、3 不清理 worktree;丢弃必须输入 discard 确认。