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