finishing-a-development-branch · 开发分支收尾

开发分支收尾 skill:开发完成后决定如何集成工作。核心流程:先验证测试全绿 → 检测环境(普通仓库 / 命名 worktree / detached HEAD)→ 确认基准分支 → 把选项摆出来等用户选 → 执行 → 清理。
选项按环境严格限定:普通仓库和命名分支给"本地合并 / 推并建 PR / 保持原样"三选一;detached HEAD 只有"推新分支建 PR / 保持原样"(无合并)。合并前必须先在合并结果上重新跑测试;废弃分支只能在用户明确要求并键入 discard 确认后执行。
调用示例:在聊天框中说"开发完成了,测试都过了,决定一下怎么合"。
产品详解
定位
finishing-a-development-branch 是开发分支的集成决策器:只在实现完成且测试全绿后触发,管"怎么集成",不管实现本身。
核心能力
- 测试先行:先跑完整测试套件;失败则报告失败并停止,不进入选项。
- 环境检测:普通仓库 / 命名 worktree / detached HEAD,决定给哪个选项菜单、如何清理。
- 基准分支确认:确认分支是从哪里分出来的,合并前确认,防错合。
- 固定选项菜单:按原文呈现菜单,不自行发挥;集成决策是用户的决定,skill 负责呈现和等待。
- 执行选择:本地合并(合并前先合并后跑测试,红了就停)/ 推并建 PR(按仓库 PR 模板,worktree 保留以修 PR 反馈)/ 保持原样。
- 谨慎清理:worktree 清理走来源判断(Superpowers 创建的 worktree 才删);移除被拒时绝不擅自
--force,把未提交文件清单摆出来让用户选。
工作流程
- 验证测试(失败则停止)
- 检测环境(确定菜单与清理方式)
- 确认基准分支
- 按原文呈现选项,等用户选择
- 执行选择(合并 / 推 PR / 保持)
- 清理(worktree 与分支,按规则)
输入与输出
| 输入 | 说明 |
|---|---|
| 开发分支 | 实现完成、测试全绿 |
| 基准分支 | 未知则询问确认 |
输出:集成结果(合并完成 / PR 链接 / 分支保留),或废弃确认流程。
适用场景
- 功能开发完成、测试全绿,决定合并方式
- worktree 多分支协作的收尾与清理
- 需要严格合并纪律的团队开发流程
使用前准备
- 实现完成,所有测试通过。
- 知道分支的基准分支(不确定时会被询问)。
finishing-a-development-branch 隶属于 Aiglade Skill 库。在 Aiglade 聊天框中用自然语言描述需求即可调用。