| name | finishing-a-development-branch |
| description | 完成开发分支的收尾工作。四选项决策树:合并、创建 PR、保留、丢弃。触发短语:"完成分支"、"合并"、"提交 PR"。 |
| allowed-tools | Read, Bash, Glob, Grep |
/finishing-a-development-branch — 完成开发分支
流程
第一步:验证状态
git branch --show-current
git log main..HEAD --oneline
git diff main...HEAD --stat
如果有未提交的改动,先提交。如果测试未通过,先修复。
第二步:呈现选项
向用户呈现四个选项:
分支收尾选项:
1. 合并到 main — 直接合并(适合小改动、个人项目)
2. 创建 PR — 推送并创建 Pull Request(适合团队协作)
3. 保留分支 — 暂不处理(适合未完成的工作)
4. 丢弃分支 — 删除分支和所有改动(适合废弃的实验)
请选择:
第三步:执行选择
选项 1:合并到 main
git checkout main
git merge --no-ff {branch-name}
合并后确认测试通过。
选项 2:创建 PR
git push -u origin {branch-name}
gh pr create --title "{标题}" --body "{描述}"
PR 描述应包含:
- 变更摘要
- 相关的 spec.md 或 plan.md 链接
- 测试计划
选项 3:保留分支
告知用户分支名和恢复方式。无需操作。
选项 4:丢弃分支
此操作不可逆,执行前必须确认。
git checkout main
git branch -D {branch-name}
第四步:清理 worktree
如果分支关联了 worktree,清理它:
git worktree remove .worktrees/{branch-name}
第五步:确认完成
分支 {branch-name} 已 [合并/PR 已创建/保留/丢弃]。
当前在 main 分支。