SuperAPI AI 工具集

moai-workflow-release

部署与运维

查看项目

更新于 10-15 21:36

技能介绍

用途:这是 MoAI-ADK 的开发者专用生产发布技能,面向 moai-adk-go 维护者,实现 Enhanced GitHub Flow,用于把 Go 版 moai-adk 发版到生产环境。

核心流程:发布分支为 release/vX.Y.Z(从 main 分出,经 PR 合并),紧急修复用 hotfix/vX.Y.Z-*(从最新 tag 分出,合入 main);目标分支 main;标签格式 vX.Y.Z(SemVer,由 .github/workflows/release.yml 触发 GoReleaser)。

工作阶段:Phase 0 预检工作区是否干净、切到 main 并拉取、创建发布分支;Phase 1 质量门禁,运行 go test -race ./... -count=1、go vet ./...、gofumpt -l .;Phase 2 代码评审;Phase 3 版本选择并更新多个版本文件;Phase 4 生成英文优先的双语 CHANGELOG;Phase 5 最终确认;Phase 6 由 manager-git 子代理(需 isolation: "worktree")推送分支、创建 PR、等待 CI 并合并、打标签;Phase 7 等待 GoReleaser 并替换为双语 Release Notes;Phase 8 更新本地二进制与模板。

关键约束:合并必须使用 merge commit,禁止 squash(gh pr merge --merge --delete-branch);标签必须通过 ./scripts/release.sh vX.Y.Z 或 make release V=vX.Y.Z 创建,禁止手动 git tag + push;PR 需带 type:、priority:、area:* 三轴标签;分支保护开启 enforce_admins,禁止直接推 main;所有 git 操作须委派 manager-git 子代理。

产物与校验:发布资产预期 6 个二进制包(darwin/linux/windows 的 arm64、amd64)加 checksums.txt,共 7 个文件;归档命名不带 v 前缀(如 moai-adk_2.1.0_darwin_arm64.tar.gz),否则更新检查器会失败。Release URL 形如 https://github.com/modu-ai/moai-adk/releases/tag/vX.Y.Z。

限制:资料未提供权限要求、失败回滚细节与耗时估算。