gh-merge

# GitHub 合并代码流程 将当前分支的代码通过 Pull Request 合并到 GitHub 目标分支。 ## 使用方式 ``` /gh-merge # 合并到 main（默认） /gh-merge develop # 合并到 develop 分支 /gh-merge --squash # 使用 squash 方式合并 ``` ## 使用流程 ### 1. 确认状态 ```bash git status git branch --show-current git remote -v gh auth status ``` **前置检查：** - 当前分支不能是目标分支 - `gh` CLI 已认证 - **识别 GitHub remote 名称**：检查 `git remote -v` 输出，找到指向 `github.com` 的 remote（可能是 `origin`、`github` 或其他名称），后续所有 git push/fetch 命令都使用该 remote 名称 ### 2. 提交代码 如有未提交的更改，先提交： ```bash git add <files> git commit -m "feat/fix/refactor: 描述更改内容" git push -u <github-remote> <current-branch> ``` **注意：** - 优先 `git add <具体文件>` 而非 `git add .`，避免意外提交敏感文件 - push 时使用步骤 1 识别的 GitHub remote 名称 ### 3. Rebase 到最新目标分支 合并前先 rebase，减少冲突风险： ```bash git fetch <github-remote> main # 如有未提交的更改，先 stash git stash # 仅在有 unstaged changes 时执行 git rebase <github-remote>/main # rebase 完成后恢复 stash git stash pop # 仅在之前执行了 stash 时 # rebase 改变了历史，需要 force push git push --force-with-lease <github-remote> <current-branch> ``` **如果 rebase 有冲突：** 1. 解决冲突文件 2. `git add <resolved-files>` 3. `git rebase --continue` 4. 重复直到 rebase 完成 5. `git push --force-with-lease` ### 4. 创建 Pull Request ```bash gh pr create --base main --title "PR标题" --body "描述" ``` 记录返回的 PR 编号（如 `#42`）。 ### 5. 等待并监控 CI Checks（关键步骤） **⚠️ 绝对不能跳过此步骤。必须确认 CI 全部通过后才能合并。** ```bash # 等待 CI 触发（GitHub Actions 有 10-30 秒延迟） sleep 30 # 等待所有 checks 完成 gh pr checks <pr-number> --watch --interval 15 --fail-fast ``...