SuperAPI AI 工具集

finishing-a-development-branch

编程与开发

查看项目

更新于 10-16 01:50

技能介绍

用途:在开发工作完成、所有测试通过后,帮助决定如何整合分支,规范收尾流程。核心原则为:验证测试→呈现选项→执行选择→清理。开始时需声明正在使用该技能。

主要能力与流程:

  1. 验证测试。先运行项目测试套件,如 npm test、cargo test、pytest、go test ./...。若测试失败则停止,不进入下一步;测试通过才继续。
  2. 确定基础分支。可用 git merge-base HEAD main 或 git merge-base HEAD master,或向用户确认分支来源。
  3. 呈现四个固定选项:本地合并回基础分支;推送并创建 Pull Request;保持分支原样稍后处理;丢弃此工作。不添加多余解释。
  4. 执行所选操作。选项1切换并更新基础分支后合并,验证合并结果测试,通过后删除功能分支。选项2推送分支并用 gh pr create 创建 PR,正文包含 Summary 与 Test Plan。选项3仅报告保留分支与工作树,不清理。选项4需用户输入 discard 确认,再删除分支。
  5. 清理工作树。选项1、2、4检查并移除 worktree;选项3保留。

限制与注意:绝不带着失败测试继续,不在未验证合并结果测试的情况下合并,不未经确认删除工作,不未经明确要求强制推送。避免开放式提问、自动清理工作树、丢弃无确认等常见错误。选项2、3 应保留工作树。该技能可被 subagent-driven-development 第7步与 executing-plans 第5步调用,并与 using-git-worktrees 配合清理其创建的工作树。具体项目命令与路径依据实际情况填写。