用途:指导将单个变更从合并推进到发布上线,覆盖 CI、release、stage 部署、canary、灰度、验证、回滚和 flag。要求先读 AGENTS.md,并按项目映射确定命令、审批边界、负责人与证据。
主要概念:Candidate 为待发布的精确 commit 与部署版本;Stage 为具名部署环境;Canary 为更广泛发布前的隔离部署;Promotion 使已检查 candidate 生效;Qualification 为通过指定检查;Readback 从 provider 读回已部署状态;Adapter 连接发布流程与部署 provider;Rollback 让先前记录版本重新生效且不重建,不回滚已存储数据或数据库变更;Flag 为获批开关;CI 为自动检查;CLI 为命令行;Effect 为带类型化失败与所需服务的库;Service 为单一职责接口;WAIT 为带证据条件的暂停;HOLD 为等待决策的停止,不宣告失败也不触发回滚。
流程:1) 先读当前部署可用性,自动生产发布、自动阶段发布、promotion 前后自动回滚、provisioned canary stage、gradual rollout 均为 off,deploy runner 为 local,off 即不可用于运维;2) 每个 PR 只发布一个小变更,新行为置于获批 flag 后;记录 candidate commit、部署版本、基线、观察到的变更与发布负责人及失败时恢复版本;本地跑快速检查,CI 对 candidate 跑全量;遵守可合并人、分支保护与依赖 PR 顺序;无标签 Kodiak 下合格 PR 在 CI 通过后自动合并,NO MERGE 用于阻止,WAIT[candidate-ci] 等到合并 commit 过 CI 与阶段检查;3) 读 runner 选择与 deploy key,仅用标记为 on 的部署功能,同一 stage 变更须串行,WAIT[stage-queue] 等到获批发布排队,最新合格 candidate 替换旧队列;4) 读灰度、canary 与发布后检查,分别报告代码就绪、已部署与行为已验证;5) 回滚前读回滚说明,WAIT[release-scope]、WAIT[adapter-qualification]、WAIT[rollback-target] 未满足即停止;缺失证据停止部署,HOLD 等待决策;6) 保持发布流程与可用部署功能同步,脚本仅为薄启动器。
限制:无发布队列或调度器,需由授权负责人按手动流程执行;无共享的阻塞步骤记录;当前无已记录发布列表或部署可用性生成块;回滚仅恢复代码。