Ship Workflow Land

Land — 合并 PR 并验证部署

入口/出口

• 入口: 通过 review 的 PR
• 出口: docs/features/<name>/07-deploy-report.md
• 输出路径: 07-deploy-report.md → ship-workflow-canary
• 指向: 部署成功建议 ship-workflow-canary 监控
• 前置加载: CANON.md

何时不使用

• PR 尚未通过 review 或仍有阻塞问题
• 当前任务只是本地提交、版本 bump 或准备 ship checklist
• 合并已经完成，只需要 canary 或 doc sync

Iron Law

流程

Step 1：检测 PR

确认 PR 状态：gh pr view --json number,title,reviewDecision,statusCheckRollup,mergeable

前置条件：OPEN + APPROVED + MERGEABLE。不满足时停止并报告阻塞项。

Step 2：等 CI 通过（Green CI Gate）

持续监控 CI 直到全部绿色或超时（15 分钟）。

超时处理： 15 分钟超时 → 报告哪些 check 仍在运行；CI 失败 → 停止，不合并。查看失败日志：gh run view <run-id> --log-failed

CI 失败时唯一允许操作： 在 PR 分支修复 → 推送 → 重新等待 CI 全绿。绝不在 CI 红灯时合并。

Step 3：合并准备度检查

CI 绿色后最终确认：

• CI 全部绿色（不是"大部分绿色"）
• Review 未过期（7 天内批准，超期需重新确认）
• PR body 准确描述了变更
• 如 PR 分支落后于 base，先 rebase 或 merge base

Step 4：合并 PR

gh pr merge --squash --delete-branch  # 默认策略
gh pr merge --merge --delete-branch    # 项目约定用 merge commit 时

合并后验证：确认 state=MERGED。远程分支立即删除；本地分支在部署成功后再清理。

Step 5：检测部署策略

读取项目配置确定部署方式：

Step 6：等部署完成（Readiness Probe）

根据部署策略监控进度。10 分钟超时。超时后不假设失败——报告状态让 human partner 决定。

Step 7：健康验证

curl 健康检查端点（/health、/api/status、/api/readyz、/version）。

通过条件：所有端点返回预期 status + 响应时间 < 5000ms + /version 返回新版本号。失败时不自动回滚，报告结果让 human partner 决定。

Step 8：回滚能力确认

获取合并 commit SHA，验证 revert 命令可用。回滚剧本：git revert -m 1 <sha> → git push origin main → 等待自动部署。

回滚触发条件：健康检查 5xx、关键业务流程不可用、human partner 要求。

输出

生成 docs/features/<name>/07-deploy-report.md，作为 production deployment closure record，包含部署范围、ship/canary 带入状态、CI / merge 状态、部署策略、生产验证证据、回滚就绪、最终部署状态和 follow-up owner。

验证证据

输出或记录必须包含：输入/来源、执行动作、验证结果、阻塞/回退。

常见说辞

红旗

• CI 红灯时尝试合并
• 跳过健康验证直接宣布"部署成功"
• 合并后不删除远程分支（分支泄漏）
• 7 天前的 review 未重新确认就合并
• 没有确认部署策略就开始"等部署"
• 部署超时后假设成功
• 没有回滚路径就合并
• 合并后第一小时无人关注

验证失败处理

验证清单

• PR review 状态为 APPROVED
• CI 全部绿色（无一例外）
• Review 未过期（7 天内）
• PR body 准确描述变更
• PR 已成功合并（state=MERGED）
• 远程分支已清理
• 部署策略已检测
• 部署已成功完成
• 健康检查端点全部通过
• 新版本号已确认
• 回滚路径已验证
• Ship / Canary Carryover 已带入 05-ship.md 和 06-canary-report.md 状态
• Production Verification 已记录健康、版本、关键路径和监控证据
• Final Deployment Status 已记录 deployed / rolled-back / paused / failed
• Follow-up / Ownership 已记录剩余动作和下一命令
• 07-deploy-report.md 已生成

输出模板

模板起点：templates/feature/07-deploy-report.md

# <Feature Name> — Deploy Report

## Deploy Summary
- Owner:
- Date:
- PR:
- Merge SHA:
- Status: pending / merged / deployed / rolled-back / blocked

## Deploy Scope
- Environment:
- Service / app / artifact:
- Version / commit / release:
- Target users / traffic:
- Explicitly out of scope:

## Ship / Canary Carryover
- Ship decision:
- Ship source:
- Canary result:
- Canary source:
- Conditions carried into deploy:

## CI / Merge Status
- Review status:
- CI result:
- Duration:
- Expired approvals:
- Merge method:
- Branch cleanup:

## Deployment Strategy
- Strategy:
- Deployment target:
- Version confirmed:
- Rollout mode:
- Deployment evidence:

## Production Verification
| Check | Source | Expected | Actual | Result |
|-------|--------|----------|--------|--------|

## Rollback Readiness
- Command:
- Trigger conditions:
- Estimated time:
- Data / migration handling:
- Owner:

## Final Deployment Status
- Final status: deployed / rolled-back / paused / failed
- Decision reason:
- Production URL / artifact path:
- Completed at:

## Follow-up / Ownership
- Canary requirement:
- Monitoring owner:
- Remaining actions:
- Tracking:
- Next command: `/canary` / `/retro` / `/doc-sync` / none