git-push-secondary-merge-primary-cnlisted
Install: claude install-skill YangsonHung/awesome-agent-skills
# Git 推送副分支并合并主分支
## 概述
执行标准的双分支交接流程:在副分支完成工作并推送,再合并到主分支并推送,最后切回副分支。
- **副分支**:承载当前工作的分支,如 `dev`、`develop` 或其他集成分支。
- **主分支**:受保护的发布分支,如 `main` 或 `master`。
## 何时使用
当用户要求执行以下操作时使用本技能:
- 推送工作分支后再合并到发布分支
- 双分支同步发布流程,例如 `dev` → `main` 或 `develop` → `master`
- 在副分支完成功能后同步到主分支
- 保留主分支上的清晰合并提交,同时不丢失副分支的提交历史
## 不要使用
以下场景不要使用本技能:
- 单分支的提交/推送(使用普通的 commit + push 流程)
- 强制推送、改写历史或 rebase 操作
- 从 Git 历史生成汇总报告(请使用 `git-weekly-report-cn`)
- 评审代码变更(请使用 `code-reviewer` 或 `frontend-code-review`)
## 分支识别
1. 优先采用用户显式指定的分支名。
2. 当用户说 `dev` 或 `main`,但仓库实际使用 `develop` 或 `master` 时,先核对真实分支再选择。
3. 优先通过 `git symbolic-ref refs/remotes/origin/HEAD` 识别主分支。
4. 远端 HEAD 不可用时,优先选择已存在的 `main`,其次 `master`。
5. 当前分��若不是主分支,就将其视为副分支。
6. 若当前已在主分支且未指定副分支,优先选择已存在的 `dev`,其次 `develop`。
7. 仍无法安全确定时,向用户询问主分支和副分支名称。
## 工作流程
1. 检查仓库状态。
- 运行 `git status --short`、`git branch --show-current`、`git remote -v`。
- 确认工作区属于目标仓库。
- 不得丢弃或回滚用户改动。
- 按分支识别规则确定 `<secondary_branch>` 和 `<primary_branch>`。
2. 将工作切换到 `<secondary_branch>`。
- 已经在 `<secondary_branch>` 上则继续。
- 当前在其他分支且工作区有未提交改动时,只有 Git 允许干净切���才执行;否则停下来向用户说明阻塞原因。
- 当前在其他干净分支时,执行 `git checkout <secondary_branch>` 与 `git pull --ff-only origin <secondary_branch>`。
3. 如果 `<secondary_branch>` 上有本地改动,先提交。
- 使用 `git add` 暂存相关变更,除非用户要求更小的范围。
- 生成符合 Conventional Commits 的提交信息:英文 `type(scope):` 前缀 + 冒号后接中文摘要。
- 不允许使用 `--no-verify`。
- 钩子或校验失败时,先修复问题再提交。
- 若 `<secondary_branch>` 无本地改动,跳过提交直接进入推送步骤。
4. 推送 `<secondary_branch>`。
- 执行 `git pus