Files
eip4-platform/docs/skills/eip4-release-manage.md

1.9 KiB
Raw Blame History

Skill: eip4-release-manage

触发场景

  • 用户要求生成部署包。
  • 用户要求发布 AI 生成的功能。
  • 用户要求线上 bug 修复或回滚。

当前边界

当前 platform-ai 只生成线上人工部署包,不自动连接线上环境执行写操作。这是设计边界,不是功能缺失。

发布前检查

  1. 确认本地 auto-develop 已通过。
  2. 使用 CLI 生成 AI 功能包快照:
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar ai feature-package \
  --base-url http://localhost:8084 \
  --task-id ait-xxx \
  --change-set-id aics-xxx \
  --output target/ai-runs/feature-package.json
  1. 保存里程碑 revision:
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar ai revision \
  --base-url http://localhost:8084 \
  --task-id ait-xxx \
  --package-id aipkg-xxx \
  --note "本地门禁通过,待人工部署" \
  --output target/ai-runs/revision.json
  1. 运行离线发布校验:
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar release verify \
  --package-file target/ai-runs/feature-package.json
  1. 确认部署包包含:
    • manifest
    • SQL 草案
    • rollback SQL
    • 本地 apply evidence
    • smoke evidence
    • repair evidence
  2. 确认部署包需要人工审批。
  3. 如果包含 ${parentMenuId} 等占位符,必须人工替换并复核;release verify 默认会阻断这类包。

线上 bug 修复路径

  1. 收集线上错误日志、请求样本或人工复现步骤。
  2. 在本地创建新的 AI 修复任务。
  3. 本地执行 apply/smoke/repair。
  4. 生成新的部署包。
  5. 人工审核后走现有上线流程。

禁止事项

  • 不让 Agent 默认直接写线上数据库。
  • 不绕过部署包和人审。
  • 不把 smoke 失败的变更包交给发布流程。
  • 不发布 release verify 失败的功能包。