SuperAPI AI 工具集

finish-branch

编程与开发

查看项目

更新于 11-13 21:56

技能介绍

用途:finish-branch 用于开发工作完成后的收尾决策。当实现已完成、测试通过时,它指导用户选择如何整合该分支的工作,并执行相应命令。

核心原则:验证测试 → 展示选项 → 执行选择 → 清理。技能开始时需声明正在使用该技能完成工作。

主要流程:

  1. 验证测试:先运行项目测试套件(如 npm test、cargo test、pytest、go test ./...)。若测试失败,则停止流程,不进入下一步,必须修复后才能合并或创建 PR。
  2. 确定基线分支:通过 git merge-base 判断分支从 main 或 master 分出,或向用户确认。
  3. 展示选项:固定给出四个选项——本地合并回基线分支、推送并创建 Pull Request、保持分支原样、丢弃该工作。选项保持简洁,不附加解释。
  4. 执行选择:本地合并需切换基线分支、拉取最新、合并特性分支并再次验证测试;创建 PR 需推送分支并用 gh pr create 生成带摘要与测试计划的 PR;原样保留则报告分支与 worktree 位置、不清理;丢弃需用户输入 discard 确认后删除分支。
  5. 清理 worktree:选项 1、2、4 需清理。必须先离开 worktree 再移除,再删除分支;若移除失败可执行 git worktree prune。完整安全顺序为:记录路径 → cd 到主仓库 → 移除 worktree → 删除分支。选项 3 跳过清理。

适用场景:开发任务完成、需要合并、开 PR 或决定是否放弃分支工作时。它常被 subagent-dev 第 7 步、executing-plans 第 5 步调用,并与 workflow:git-worktrees 配合清理其创建的 worktree。

限制与注意事项:不得在测试失败时继续;不得未经确认删除工作;不得在 worktree 存在时删除分支;不得站在 worktree 内移除 worktree;不得在未明确要求时强制推送。资料给出了各选项在合并、推送、保留 worktree、清理分支上的差异表,可作为操作参考。