安装方式
手动下载安装
下载 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-base 对 main/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)。