完成开发分支

来自 Superpowers 项目的开发分支完成 Skill，在功能开发完成并测试通过后，提供结构化的工作流选项来完成开发工作。该 Skill 系统化地处理 Git 工作流的最后阶段，包括合并、PR 创建、分支保留和清理操作。

核心原则

该 Skill 遵循清晰的四步流程：验证测试 → 呈现选项 → 执行选择 → 清理。这种结构化的方法确保代码质量，同时提供灵活的工作流选择。

详细流程

步骤 1：验证测试

在呈现任何选项之前，首先验证所有测试通过。这是完成开发分支的前提条件，确保代码质量和功能正确性。

根据项目类型运行相应的测试命令：

• Node.js 项目：npm test 或 yarn test
• Rust 项目：cargo test
• Python 项目：pytest 或 python -m unittest
• Go 项目：go test ./...

只有在所有测试通过后，才会进入下一步。如果测试失败，需要先修复问题。

步骤 2：呈现选项

测试通过后，向用户呈现四种结构化的完成选项：

合并到 main：适用于简单、低风险的更改，可以直接合并到主分支。这种方式快速高效，适合个人项目或小型团队的简单修改。

创建 PR（Pull Request）：适用于需要团队审查的更改。创建拉取请求，让团队成员进行代码审查、讨论和批准。这是团队协作开发的标准流程。

保留分支：如果工作尚未完全完成，或者需要稍后继续开发，可以选择保留分支。分支和 worktree 会被保留，方便后续继续工作。

清理：如果分支的工作已经完成且不再需要，可以选择清理。这会删除本地分支和相关的 worktree，保持仓库整洁。

步骤 3：执行选择

根据用户选择，系统化地执行相应的工作流：

• 执行合并：切换到 main 分支，合并开发分支，推送到远程仓库
• 创建 PR：推送分支到远程，使用 gh 命令创建 Pull Request
• 保留分支：提交当前更改，确保工作不会丢失
• 执行清理：删除本地分支，清理 worktree，更新远程追踪

每个工作流都包含完整的步骤，确保操作的完整性和一致性。

步骤 4：验证完成

执行完成后，验证操作结果：

• 检查 Git 状态
• 确认分支状态
• 验证远程同步

应用场景

功能开发完成：在完成一个功能分支的开发并通过测试后，使用该 Skill 来决定下一步操作。

代码审查流程：为需要团队审查的代码创建 PR，启动代码审查流程。

快速修复：对于简单的 bug 修复或小改动，可以直接合并到主分支。

工作暂停：当需要暂时切换到其他任务时，保留当前分支以便后续继续。

仓库维护：定期清理已完成的分支，保持仓库整洁。

应用价值

该 Skill 为开发分支的完成提供了标准化的流程，避免了手动操作可能出现的遗漏和错误。通过强制测试验证，确保只有通过测试的代码才能进入下一阶段。

结构化的选项呈现使开发者能够根据具体情况选择合适的工作流，既支持快速的个人开发，也支持严格的团队协作流程。系统化的执行确保每个步骤都被正确完成，减少了 Git 操作错误的风险。

对于使用 Git worktree 工作流的团队，该 Skill 特别有价值，它简化了 worktree 的管理和清理工作。