Files
eip4-platform/docs/skills/eip4-release-manage.md
zhengwr 5b06aeceff feat(cli): eip4 init 一键接入 Claude Code/Codex/OpenCode (G1)
- 新增 eip4 init:把 agent skills 装到目标项目
  - Claude Code → .claude/skills/<name>/SKILL.md(代码生成 frontmatter)
  - Codex/OpenCode → 根 AGENTS.md(EIP4-SKILLS 标记块,内嵌 skill 全文,块外保留,幂等)
  - base URL 按 --base-url/--env/current env 渲染
- docs/skills/*.md 的 base URL 改为 {{EIP4_BASE_URL}} 占位符
- 新增 eip4-skills/manifest.json + pom 用 maven-resources-plugin 把 docs/skills 打进 jar(init 默认从 classpath 读,无需仓库在场)
- 文档:AI_AGENT_Nocobase_INTEGRATION_GAP_AND_PLAN(NocoBase 对照 + G1-G3 计划)、skills/README、平台 README
- TDD 5 个新测试,platform-cli 共 20 单测全绿;真实 jar 端到端验证通过

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-22 14:14:26 +08:00

2.9 KiB
Raw Permalink 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 {{EIP4_BASE_URL}} \
  --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 {{EIP4_BASE_URL}} \
  --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. 导出 .eip4pkg.json 并做导入预览:
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar release export \
  --package-file target/ai-runs/feature-package.json \
  --output target/ai-runs/feature-package.eip4pkg.json

java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar release import-preview \
  --package-file target/ai-runs/feature-package.eip4pkg.json
  1. 如存在上一版功能包,先做离线差异检查:
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar release diff \
  --left target/ai-runs/feature-package-old.json \
  --right target/ai-runs/feature-package.json
  1. 需要回滚预案时,只生成回滚计划文件:
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar release rollback-plan \
  --package-file target/ai-runs/feature-package.eip4pkg.json \
  --output target/ai-runs/rollback-plan.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 失败的功能包。
  • 不把 import-preview 当成导入或启用;它只是离线检查。
  • 不把 rollback-plan 当成回滚执行;它只生成计划和 SQL 清单。