SuperAPI AI 工具集

finishing-a-development-branch

编程与开发

查看项目

更新于 10-15 21:04

技能介绍

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

主要能力与流程:

  1. 验证测试:先运行项目测试套件(如 npm test、cargo test、pytest、go test ./...)。若测试失败,须先修复,不得进入下一步。
  2. 确定基础分支:用 git merge-base HEAD main 或 master 判断,或向用户确认;并阅读 AGENTS.md 与维护者文档,检查基础分支的保护规则。若强制 PR 或必需检查,则本地合并不可用,改用受保护的 PR/合并流程。
  3. 呈现选项:对未受保护的基础分支,给出四个选项——本地合并回基础分支、推送并创建 PR、保持分支原样、丢弃工作。对受保护分支不提供本地合并,仅保留后三项。
  4. 执行选择:本地合并需先确认策略与保护允许,再 checkout、pull、merge、在合并结果上验证测试并删除分支;创建 PR 使用 git push -u origin 与 gh pr create;保持原样则保留工作树;丢弃需输入 discard 确认后强制删除分支。
  5. 清理工作树:选项 1、2、4 清理,选项 3 保留。

适用场景:实现完成、测试通过、需要整合分支时;常被 subagent-driven-development 与 executing-plans 调用,并与 using-git-worktrees 配合。

限制:仅在任务明确匹配上述范围时使用;输出不能替代环境相关验证、测试或专家审查;缺少必要输入、权限、安全边界或成功标准时应停止并请求澄清。禁止在测试失败时继续、未验证合并结果即合并、未确认即删除工作、未经明确请求强制推送。