SuperAPI AI 工具集

release-core

部署与运维

查看项目

更新于 10-16 01:33

技能介绍

用途:这是 mx-space/core 仓库的发布辅助技能,面向三类发布流水线——A 服务端 apps/core(DockerHub innei/mx-server、GitHub Release zip、Dokploy 重新部署)、B npm 包 @mx-space/api-client、C npm 包 @mx-space/cli(二进制 mxs)。使用前需与用户确认走哪条流水线。

主要能力:辅助脚本位于 .claude/skills/release-core/scripts/,会输出紧凑可验证的结果。服务端流程包括预检与版本决策(bash .claude/skills/release-core/scripts/preflight.sh core)、准备(prepare-server.sh X.Y.Z,含 bump-admin-version、生成 CHANGELOG、备份并删除 RELEASE_NOTES.md)、撰写 apps/core/RELEASE_NOTES.md、收尾并观察 CI(finalize-server.sh X.Y.Z,提交 release: vX.Y.Z、打注解标签、推送触发 release.yml,再用 gh run watch <run-id>)。npm 包流程用 preflight.sh api-client 或 preflight.sh cli 决定版本,再执行 release-package.sh api-client X.Y.Z 或 release-package.sh cli X.Y.Z,内部会校验 npm whoami、类型检查与测试、重建 dist、发布并核对版本。

版本规则:patch 对应 fix/docs/chore/refactor/test,minor 对应 feat,major 对应 BREAKING CHANGE 或 feat!/fix!(须与用户确认);cli 为 0.y.z,feat 与破坏性变更都按 minor,1.0.0 保留给 API 冻结。CI 在标签上运行 lint、typecheck 与冒烟测试,失败应向前修复补丁,不要重新打标签或删除已发布标签。

限制与安全:流程中禁止 git reset --hard、git checkout --、git restore、force-push 等破坏性操作;发布前若预检出现 RED、admin 版本未变、npm 未登录、流水线混淆等情况须停下与用户确认。回滚场景按资料给出的对应处理方式执行,npm 发布失败可在包目录重跑 pnpm publish --access=public --no-git-checks。