安装方式
手动下载安装
下载 ZIP 后解压到技能目录即可安装。若在桌面客户端 WebView中直接下载出现异常，本站会改为提示页 + 原始链接，请按页内说明操作。
下载 ZIP (oss-superpowers-finishing-a-development-branch-v1.0.0.zip)触发指令
/finishing-a-developm
跨平台安装指引
该技能声明兼容以下 1 个平台，将 ZIP 解压到对应目录即可被识别。
unzip oss-superpowers-finishing-a-development-branch-v1.0.0.zip -d ~/.claude/skills/
mkdir -p 创建；启用 Skill 后请重启对应 Agent 让配置生效。
使用指南
完成开发分支
实现告一段落、测试通过后，用 清晰选项 引导 如何集成或清理。
核心： 验证测试 → 给出选项 → 执行选择 → 清理 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）。
<!-- zh-only -->
# 完成开发分支
实现告一段落、测试通过后，用 **清晰选项** 引导 **如何集成或清理**。
**核心：** 验证测试 → 给出选项 → 执行选择 → 清理 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）。