finishing-a-development-branch

npx skills add jnMetaCode/superpowers-zh --skill finishing-a-development-branch --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

# 完成开发分支 ## 概述 通过提供清晰的选项并执行所选工作流来引导开发工作的收尾。 **核心原则：** 验证测试 → 检测环境 → 展示选项 → 执行选择 → 清理。 **开始时宣布：** "我正在使用 finishing-a-development-branch 技能来完成这项工作。" ## 流程 ### 步骤 1：验证测试 **在展示选项之前，验证测试通过：** ```bash # 运行项目的测试套件 npm test / cargo test / pytest / go test ./... ``` **如果测试失败：** ``` 测试失败（<N> 个失败）。必须先修复才能继续： [显示失败信息] 在测试通过之前无法进行合并/PR。 ``` 停止。不要继续到步骤 2。 **如果测试通过：** 继续步骤 2。 ### 步骤 2：检测环境 **在展示选项之前，先确定工作区状态：** ```bash GIT_DIR=$(cd "$(git rev-parse --git-dir)" 2>/dev/null && pwd -P) GIT_COMMON=$(cd "$(git rev-parse --git-common-dir)" 2>/dev/null && pwd -P) ``` 这决定了展示哪种菜单、以及清理方式： | 状态 | 菜单 | 清理 | |------|------|------| | `GIT_DIR == GIT_COMMON`（普通仓库） | 标准 4 个选项 | 无 worktree 可清理 | | `GIT_DIR != GIT_COMMON`，命名分支 | 标准 4 个选项 | 按来源判断（见步骤 6） | | `GIT_DIR != GIT_COMMON`，分离 HEAD | 收敛 3 个选项（无合并） | 无清理（由外部管理） | ### 步骤 3：确定基础分支 ```bash # 尝试常见的基础分支 git merge-base HEAD main 2>/dev/null || git merge-base HEAD master 2>/dev/null ``` 或者询问："这个分支是从 main 分出来的——对吗？" ### 步骤 4：展示选项 **普通仓库和命名分支 worktree —— 准确展示以下 4 个选项：** ``` 实现已完成。你想怎么做？ 1. 在本地合并回 <base-branch> 2. 推送并创建 Pull Request 3. 保持分支现状（我稍后处理） 4. 丢弃这项工作 选哪个？ ``` **分离 HEAD —— 准确展示以下 3 个选项：** ``` 实现已完成。你在分离 HEAD 上（由外部管理的工作区）。 1. 作为新分支推送并创建 Pull Request 2. 保持现状（我稍后处

npm test / cargo test / pytest / go test ./...
git merge-base HEAD main 2>/dev/null || git merge-base HEAD master 2>/dev/null
cd "$MAIN_ROOT"
git checkout <base-branch>
git pull
git merge <feature-branch>
git branch -d <feature-branch>
git push -u origin <feature-branch>
gh pr create --title "<title>" --body "$(cat <<'EOF'
git branch -D <feature-branch>