完成开发分支

工程开发 社区

技能解读

设计思路

finishing-a-development-branch 是 superpowers 的「开发完成扫尾」skill——按一份精确的 4 选项菜单完成分支收尾,避免「合并到主分支后 CI 挂」「worktree 残留」「分支白白挂着」这类常见烂尾。作者把它做成 mechanical 的决策树,每一步都对应明确条件,不留发挥空间。

4 选项(detached HEAD 时降到 3 选项)

选项 Merge Push Keep Worktree Cleanup Branch
1. Merge locally yes - - yes
2. Create PR - yes yes -
3. Keep as-is - - yes -
4. Discard - - - yes(force)

关键纪律:

  • 选 1 / 选 4 才清 worktree——选 2 用户后续 PR iteration 还要用,别动。
  • 先 merge 再 remove worktree 再 delete branch——git branch -d 在 worktree 还引用这个分支时会失败。
  • cd 回主仓再跑 git worktree remove——在 worktree 内部跑会静默失败。
  • 跑完 git worktree prune 自愈清理 stale 注册。
  • Discard(选 4)必须打字 "discard" 二次确认——防误删。

Worktree 归属判断

只清理 .worktrees/ / worktrees/ / ~/.config/superpowers/worktrees/ 这三种自创的 worktree。harness 创的(IDE / 平台拥有的)绝不动——会留下幻影状态。

常见错误(按作者原文摘录)

  • 跳过测试验证:合了挂代码或开了挂的 PR——所以提供选项前先验证。
  • 开放式问题:「你下一步想做什么?」——必须给精确 4 选项。
  • 删 branch 之前不删 worktree:branch -d 失败。
  • 在 worktree 内跑 git worktree remove:静默失败——必须 cd 回主仓再跑。
  • Discard 没二次确认:手滑就丢工作。

Red Flags(永远不做)

  • 测试挂还往下走
  • merge 完不再验测
  • 不让用户确认就删工作
  • 没明确许可就 force-push
  • 没确认 merge 成功就删 worktree
  • 清不是自己造的 worktree(provenance check)

适合谁

  • 完成 task 后想稳妥收尾的工程师
  • 多 worktree 工作流的核心收尾节点
  • 团队有「PR 创建标准化」要求的项目

不适合

  • 还在开发中——这是终点,不是中途
  • 不在 git 仓库——大量步骤无效

配套

writing-plans(开始)→ executing-plans(执行)→ finishing-a-development-branch(收尾);多 worktree 时用 using-git-worktrees 协同。

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
工程开发
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@obra · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
不需要
兼容的系统
macOS · Linux · Windows
运行环境要求
未检出明确要求
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 命令执行
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
第 1 步:验证测试

运行项目的完整测试套件(`npm test` / `cargo test` / `pytest` / `go test ./...`)。如果测试失败,报告失败并停止 — 菜单出现在绿色套件之后: 如果测试通过:继续执行步骤 2。

02
第2步:检测环境

这决定了要显示的菜单以及清理的工作方式:状态·菜单·清理`GIT_DIR == GIT_COMMON`(正常存储库)·标准3个选项·没有要清理的工作树`GIT_DIR != GIT_COMMON`,命名分支·标准3个选项·基于来源(参见步骤6)`GIT_DIR != GIT_COMMON`,分离的HEAD·减少2个选项(无合并)·外部管理-保留在原处

03
第三步:确定基础分支

基础分支是该工作的分支——通常在计划、对话或分支的上游中命名。如果还不知道,请问:“这个分支是从<你的最佳猜测>中分离出来的 - 这是正确的吗?”合并前确认:合并到错误的碱基中,撤消代价高昂。

04
第四步:提出选项

普通存储库和命名分支工作树 — 准确地显示这 3 个选项: 分离的 HEAD — 准确地显示这 2 个选项: 准确地显示所写的菜单 — 简洁,每个选项都来自上面的列表。仅当您的人类合作伙伴明确要求时,才会放弃工作(请参阅“如果您的人类合作伙伴要求

05
第 6 步:清理工作区

运行选项 1 并确认弃牌。选项 2 和 3 始终保留工作树。两个调用者都已将目录更改为主存储库根目录 - 工作树删除必须从工作树外部运行 - 并使用步骤 2 中捕获的目录更改之前的 `GIT_DIR`/`GIT_COMMON`/`WORKTREE_PATH` 值。

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。