用途：规范 Kortix 生产发布，分为“定版本”和“怎么发”两部分。发布说明会写入 GitHub Release，并被公开 /changelog 页面渲染，因此必须真实反映已发布内容。版本唯一来源是根目录 VERSION 文件，vX.Y.Z 标签不可变，与提交和镜像一一对应。
主要能力与规则：遵循 Semver MAJOR.MINOR.PATCH，默认 patch；小功能、修复、文档、基础设施用 patch，成批用户可见能力用 minor，破坏性变更或架构调整用 major。生产只能从 staging 发布，禁止直接 push 到 prod、手动开 prod PR 或 cherry-pick。main 为开发主干，staging 为生产候选分支。
使用方式：先取最近发布标签，再完整读取该标签到 origin/staging 的全部提交作为发布说明素材；据此写标题与分组说明。发布前确认 staging 健康、runtime-config 指向 staging 域名、QA 针对 staging。随后运行 promote.yml，需提供 title 与 notes，可指定 bump=patch 或 version=X.Y.Z；它会创建受审查的 release PR，合并后 deploy-prod 重打 staging 镜像标签、跑迁移、滚动 EKS、生成 GitHub Release 并部署 Vercel。最后验证 api.kortix.com 健康与 Release 内容。
限制与注意：deploy-prod 并发为 cancel-in-progress: false，慢构建或排队任务会阻塞后续部署；不要发布仍在变动的 staging；/changelog 只显示 ≥1.0.0 且读取 Release 正文。误发未真正上线可用删标签、重置 prod、revert 版本提交并删除 Release；已上线版本应使用 rollback-prod.yml 回滚，不强制推送 prod、不反向迁移，数据库保持前向兼容。具体命令与参数以资料原文为准。