| name | infoq-release-ops |
| description | 执行本仓库发布操作，覆盖版本升级、后端 Maven revision、前端 package 与小程序 manifest 版本、Docker 镜像标签、发布文档、DEPLOY_ID 部署批次示例、docs 同步、版本断言和发布前验证。适用于升级版本号、发布到指定 x.y.z、同步 README/docker/pom/package/manifest/doc/backend config/test 与 docs 站点版本。 |
InfoQ 发布操作
本技能只负责一件事：发布相关版本与文档同步。它是写入型高风险领域 SOP，默认先 dry-run 和影响检查，再执行实际版本变更。
执行顺序
- 判定范围：确认目标是版本升级、发布前检查、Docker tag、package/manifest 同步、docs 同步，还是发布文档更新。
- 目标枚举：列出目标版本、受管文件、工作区、
DEPLOY_ID 示例、SQL 策略、依赖/lockfile 影响、docs 影响和回滚条件。
- 预览优先：先运行
bump_version.mjs --dry-run <version>，核对输出后再执行写入。
- 写入执行：实际运行版本升级脚本后，检查变更文件和脚本输出，不手工散改版本字段。
- 发布前验证：执行脚本回归、版本断言、依赖一致性、config/SQL/dependency/rollback/observability 检查。
- 失败处理：docs 同步、版本断言、lockfile 不一致或 SQL 策略冲突时显式失败；SQL 或数据迁移细节转交
infoq-data-ops，不继续发布。
默认命令
升级版本：
node .codex/skills/infoq-release-ops/scripts/bump_version.mjs 2.0.3
预览：
node .codex/skills/infoq-release-ops/scripts/bump_version.mjs --dry-run 2.0.3
脚本回归：
node .codex/skills/infoq-release-ops/scripts/test_bump_version.mjs
默认 SQL 策略
- 项目版本升级与 SQL 初始化文件重命名是两个独立决策。
- 默认保持现有
sql/infoq_scaffold_x.y.z.sql 文件名不变。
- 不修改冻结初始化基线。
护栏
- 目标版本必须符合
x.y.z。
- 实际写入前必须先执行 dry-run 并核对影响范围。
- 依赖版本与 lockfile 必须保持一致。
- docs 同步脚本失败时必须显式失败。
- 发布前检查 config、SQL、dependency、rollback、observability 影响。
- 不修改冻结初始化 SQL；需要 SQL 变化时新增当前日期增量脚本。
- 发布失败或版本断言失败时，不能通过手工散改部分文件来伪造一致性。
参考
- 受管目标：
references/targets.md
- 主脚本：
scripts/bump_version.mjs
- 回归脚本：
scripts/test_bump_version.mjs
