SuperAPI AI 工具集

finishing-a-development-branch

编程与开发

查看项目

更新于 10-16 03:04

技能介绍

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

主要能力与用法:

  1. 验证测试:先运行项目测试套件(如 npm test、cargo test、pytest、go test ./...)。若测试失败,必须停止,不得进入下一步,也不能合并或创建 PR。
  2. 确定基础分支:可用 git merge-base HEAD main 或 git merge-base HEAD master 判断,或向用户确认分支来源。
  3. 呈现选项:只给出四个选项——本地合并回基础分支、推送并创建 Pull Request、保持分支原样、丢弃该工作。选项保持简洁,不加解释。
  4. 执行选择:
  • 本地合并:切换基础分支、拉取最新、合并特性分支、在合并结果上再次验证测试,通过后删除特性分支。
  • 推送并创建 PR:git push -u origin <feature-branch>,再用 gh pr create 创建 PR,正文包含变更摘要与测试计划。
  • 保持原样:报告保留分支与工作树位置,不清理工作树。
  • 丢弃:先列出将永久删除的分支、提交与工作树路径,要求输入 discard 确认,确认后切换基础分支并 git branch -D 删除。
  1. 清理工作树:仅对选项 1、2、4 执行;用 git worktree list 检查是否处于工作树,若是则 git worktree remove <worktree-path>。选项 3 保留工作树。

适用场景:由 subagent-driven-development(第 7 步)或 executing-plans(第 5 步)在任务或批次完成后调用,并与 using-git-worktrees 配合清理其创建的工作树。

限制与注意:不得在测试失败时继续;不得在未验证合并结果测试的情况下合并;不得未经确认删除工作;不得在未明确要求时强制推送。常见错误包括跳过测试验证、使用开放式提问、自动清理工作树、丢弃时缺少确认。