SuperAPI AI 工具集

finishing-a-development-branch

编程与开发

查看项目

更新于 10-16 09:44

技能介绍

用途:开发工作收尾时使用,在实现完成、所有测试通过后,决定如何集成工作。核心原则为验证测试、展示选项、执行选择、清理。

主要能力与流程:

  1. 验证测试:先运行项目测试套件(如 npm test / cargo test / pytest / go test ./...)。测试失败则停止,必须先修复,无法进行合并或 PR。
  2. 确定基础分支:可用 git merge-base HEAD main 或 master 判断,或直接询问。
  3. 展示 4 个简洁选项:本地合并回基础分支、推送并创建 PR、保持分支现状、丢弃工作。不添加多余解释。
  4. 执行选择:本地合并时执行 checkout、pull、merge,并在合并结果上验证测试,通过后 git branch -d 删除功能分支;创建 PR 时 git push -u origin 功能分支并用 gh pr create 生成摘要与测试计划;保持现状仅报告保留分支与工作树;丢弃需先展示将删除的分支、提交与工作树,要求输入 discard 确认,确认后 checkout 基础分支并 git branch -D 删除分支。
  5. 清理工作树:选项 1、2、4 使用 git worktree list 检查并 git worktree remove 清理;选项 3 保留工作树。

适用场景:被 subagent-driven-development(步骤 7)和 executing-plans(步骤 5)调用,配合 using-git-worktrees 清理其创建的工作树。

限制与红线:测试失败时绝不继续;合并前必须验证测试;未确认不得删除工作成果;未经明确请求不得强制推送;始终准确展示 4 个选项,仅选项 4 要求确认,只在选项 1 和 4 时清理工作树。