- 新增 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>
2.9 KiB
2.9 KiB
Skill: eip4-release-manage
触发场景
- 用户要求生成部署包。
- 用户要求发布 AI 生成的功能。
- 用户要求线上 bug 修复或回滚。
当前边界
当前 platform-ai 只生成线上人工部署包,不自动连接线上环境执行写操作。这是设计边界,不是功能缺失。
发布前检查
- 确认本地 auto-develop 已通过。
- 使用 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
- 保存里程碑 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
- 运行离线发布校验:
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar release verify \
--package-file target/ai-runs/feature-package.json
- 导出
.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
- 如存在上一版功能包,先做离线差异检查:
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
- 需要回滚预案时,只生成回滚计划文件:
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
- 确认部署包包含:
- manifest
- SQL 草案
- rollback SQL
- 本地 apply evidence
- smoke evidence
- repair evidence
- 确认部署包需要人工审批。
- 如果包含
${parentMenuId}等占位符,必须人工替换并复核;release verify默认会阻断这类包。
线上 bug 修复路径
- 收集线上错误日志、请求样本或人工复现步骤。
- 在本地创建新的 AI 修复任务。
- 本地执行 apply/smoke/repair。
- 生成新的部署包。
- 人工审核后走现有上线流程。
禁止事项
- 不让 Agent 默认直接写线上数据库。
- 不绕过部署包和人审。
- 不把 smoke 失败的变更包交给发布流程。
- 不发布
release verify失败的功能包。 - 不把
import-preview当成导入或启用;它只是离线检查。 - 不把
rollback-plan当成回滚执行;它只生成计划和 SQL 清单。