用途:在无法等待常规发布流程时,把范围极小、影响面可控的紧急修复直接推到 main,并将 main 合并回 dev 以保持两分支同步。普通改动仍应走 /release,此技能只应对紧急情况。
不适用场景:多文件重构或功能开发、需要 CodeRabbit 复审或他人复核、涉及迁移、认证、计费或影响面不明确的改动,这些应改用 /release 或提热修复 PR。
前置条件:修复限于一两个文件且影响面最小;需仓库管理员权限(推送 main 会绕过分支保护,非管理员直接失败);确认没有并发的发布 PR,可用 gh pr list --label release 检查。
主要步骤:先归一化起始状态,用 git branch --show-current、git status --short、git log --oneline origin/dev..HEAD 判断;若 dev 已有本地提交则 git reset --mixed HEAD~1,再 git stash push -m "prod-hotfix",工作区干净且无本地提交时停止,要求先在 dev 上做修改。随后 git fetch origin、git pull --ff-only origin dev、git checkout main、git pull --ff-only origin main,两个 pull 都必须是快进,否则停止。接着 git stash pop 与 git diff 核对改动,冲突则停止。提交前必须依次通过 pnpm fix、pnpm lint、pnpm build,不可跳过构建。提交使用项目约定的 conventional commit,再 git push origin main,预期出现绕过分支保护的提示;若被直接拒绝说明无管理员权限,应改为向 main 提热修复 PR。最后 git checkout dev 并 git merge main --no-ff -m "chore(release): merge main back into dev after hotfix"、git push origin dev,用 git pull、git log --oneline -5、git log --oneline origin/main..origin/dev | head -3 确认状态干净、未误发未发布提交。
后续:热修复会触发 main 的 Vercel 生产部署,但不会运行 release-it,因此不产生新标签或 GitHub Release,下次正式发布会把该提交纳入 changelog。若涉及公开 API,需在回合并后于 dev 上更新 docs/API_CHANGELOG.md;可选在 Slack dev 频道告知。
限制与警示:任一 pull 无法快进、验证失败、stash pop 冲突、推送被拒或回合并后出现意外提交,都应停止排查而非强行推送。资料未提供更多自动化或平台支持细节。