技能库 / 开发编程 / 收尾开发分支

收尾开发分支

实现完成且测试通过后,决定合并、发 PR、清理分支或后续协作方式。

v1.0.0
作者 / 来源

github-obra

在来源站打开

安装方式

CLI 安装(推荐)

claw install oss-superpowers-finishing-a-development-branch

需要安装 CLAW CLI

手动下载安装

下载 ZIP 后解压到技能目录即可安装。若在桌面客户端 WebView中直接下载出现异常,本站会改为提示页 + 原始链接,请按页内说明操作。

下载 ZIP (oss-superpowers-finishing-a-development-branch-v1.0.0.zip)

触发指令

/finishing-a-developm

使用指南

完成开发分支

实现告一段落、测试通过后,用 清晰选项 引导 如何集成或清理

核心: 验证测试 → 给出选项 → 执行选择 → 清理 worktree(若适用)。

开场宣告:「我正使用 finishing-a-development-branch 技能来收尾。」

流程

第一步:验证测试

在给出任何合并/PR 选项前,先跑测试npm test / pytest / go test ./... 等)。

若失败: 列出失败信息,说明 测试不过不能进入合并/PR 流程停止

若通过: 进入第二步。

第二步:确定基线分支

git merge-basemain/master 或询问用户:「当前分支是从 main 拉的吗?」

第三步:呈现选项(仅此四项,勿加长篇解释)

实现已完成。接下来希望怎么做?

1. 在本地合并回 <基线分支>
2. Push 并创建 Pull Request
3. 保留分支不动(稍后我自己处理)
4. 丢弃本次工作

选哪一项?

第四步:执行选择

选项 1 本地合并: checkout 基线 → pull → merge 功能分支 → 再跑测试 → 可删分支 → 按第五步清理 worktree。

选项 2 PR: push 分支 → gh pr create(摘要 + 测试计划)→ 按第五步清理 worktree(视团队习惯保留或删)。

选项 3: 报告分支名与 worktree 路径;不要 删 worktree。

选项 4: 先确认「将永久删除分支、提交列表、worktree…」;用户输入确认词后再 git branch -D 等 → 第五步清理 worktree。

第五步:清理 Worktree

对选项 1、2、4:若在 worktree 中,git worktree remove <path>。选项 3 保留。

速查表

| 选项 | 合并 | Push | 保留 Worktree | 删分支 | |------|------|------|---------------|--------| | 1 | ✓ | - | - | ✓ | | 2 | - | ✓ | ✓ | - | | 3 | - | - | ✓ | - | | 4 | - | - | - | ✓(强制) |

常见错误

  • 不测就合并/PR
  • 开放式问「接下来干啥」 而非四选一
  • 错误时机删 worktree(例如还要用本地改 PR)
  • 丢弃前不二次确认

禁止 / 必须

禁止: 测试失败仍推进;合并后不验证;无确认强删;未经要求强推。
必须: 给选项前先测;恰好四个选项;选项 4 要打字确认;仅对 1 与 4 按规则清理 worktree。

衔接

调用方: subagent-driven-development(全部任务后)、executing-plans(全部批次后)。
常配对: using-git-worktrees(创建与清理 worktree)。