feat: add EIP4 agent CLI and skills plan
This commit is contained in:
20
docs/skills/README.md
Normal file
20
docs/skills/README.md
Normal file
@@ -0,0 +1,20 @@
|
||||
# EIP4 Agent Skills
|
||||
|
||||
本目录是 EIP4 给 AI Agent 使用的领域操作规程。目标是让 Codex、Claude Code、Cursor、OpenCode 等 Agent 都按同一套规则操作 EIP4,而不是临时猜接口、猜表结构或直连线上库。
|
||||
|
||||
## Skills
|
||||
|
||||
| Skill | 用途 |
|
||||
|---|---|
|
||||
| `eip4-env-manage` | 环境探测、启动检查、端口和 profile 边界 |
|
||||
| `eip4-ai-feature-development` | 从自然语言需求生成实体、服务流、页面、菜单和本地 smoke |
|
||||
| `eip4-release-manage` | 部署包、人审、发布前校验和回滚边界 |
|
||||
|
||||
## 通用原则
|
||||
|
||||
1. 优先使用 `platform-cli`,其次使用公开 REST API,最后才考虑人工 SQL。
|
||||
2. 默认只允许本地开发和测试环境自动执行写操作。
|
||||
3. 线上环境只能生成部署包和校验证据,不能由 Agent 默认直接写入。
|
||||
4. 每次自动开发必须保留 request、draft、change-set、apply、smoke、repair、deployment package evidence。
|
||||
5. 任何失败先回到本地复现和修复,再重新生成部署包。
|
||||
|
||||
66
docs/skills/eip4-ai-feature-development.md
Normal file
66
docs/skills/eip4-ai-feature-development.md
Normal file
@@ -0,0 +1,66 @@
|
||||
# Skill: eip4-ai-feature-development
|
||||
|
||||
## 触发场景
|
||||
|
||||
- 用户描述一个新功能,希望 AI 自动生成。
|
||||
- 用户要求从 EIP3 模板、实体、服务流或页面定义生成 EIP4 功能。
|
||||
- 用户要求本地自动开发、自动修复和 smoke。
|
||||
|
||||
## 输入要求
|
||||
|
||||
最小需求应包含:
|
||||
|
||||
- 功能目标
|
||||
- 功能名称
|
||||
- 业务表名
|
||||
- 实体名称
|
||||
- 页面 templateId
|
||||
- 菜单名称
|
||||
- 字段列表
|
||||
|
||||
字段格式:
|
||||
|
||||
```text
|
||||
column:label:type[:length][:required]
|
||||
```
|
||||
|
||||
示例:
|
||||
|
||||
```text
|
||||
NAME:名称:string:100:true
|
||||
CODE:编码:string:64:true
|
||||
ENABLED:启用:boolean::false
|
||||
```
|
||||
|
||||
## 推荐命令
|
||||
|
||||
```bash
|
||||
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar ai auto-develop \
|
||||
--base-url http://localhost:8084 \
|
||||
--objective "新增客户等级维护功能" \
|
||||
--feature-name "客户等级维护" \
|
||||
--table-name EIP4AI_CUSTOMER_LEVEL \
|
||||
--entity-name "客户等级" \
|
||||
--template-id eip4ai-customer-level \
|
||||
--menu-name "客户等级维护" \
|
||||
--field NAME:名称:string:100:true \
|
||||
--field CODE:编码:string:64:true \
|
||||
--field ENABLED:启用:boolean::false \
|
||||
--max-repair-attempts 2 \
|
||||
--output target/ai-runs/customer-level.json
|
||||
```
|
||||
|
||||
## 通过标准
|
||||
|
||||
- `applyStatus` 为 `PASSED`。
|
||||
- `smokeStatus` 为 `PASSED`。
|
||||
- 最终状态为 `READY_FOR_HUMAN_REVIEW`。
|
||||
- 部署包存在且 `requiresHumanApproval=true`。
|
||||
|
||||
## 失败处理
|
||||
|
||||
1. 查看输出 JSON 中的 apply/smoke/repair evidence。
|
||||
2. 如果自动修复已尝试但失败,基于 evidence 修改本地代码或元数据生成逻辑。
|
||||
3. 重新运行本地 auto-develop。
|
||||
4. 不直接连接线上库修复。
|
||||
|
||||
34
docs/skills/eip4-env-manage.md
Normal file
34
docs/skills/eip4-env-manage.md
Normal file
@@ -0,0 +1,34 @@
|
||||
# Skill: eip4-env-manage
|
||||
|
||||
## 触发场景
|
||||
|
||||
- 用户要求启动、检查或切换 EIP4 环境。
|
||||
- 用户要求 Agent 在本地验证功能。
|
||||
- 用户要求确认当前服务是否可被 AI 自动开发链路使用。
|
||||
|
||||
## 操作规则
|
||||
|
||||
1. 确认当前目录是否是独立 worktree,避免污染用户正在做的任务。
|
||||
2. 使用 JDK 21,不能使用 JDK 26。
|
||||
3. 默认本地 profile:
|
||||
- `local`: `http://localhost:8084`
|
||||
- `dev`: `http://localhost:8093`
|
||||
4. 使用 CLI 探测环境:
|
||||
|
||||
```bash
|
||||
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar env status --base-url http://localhost:8084
|
||||
```
|
||||
|
||||
5. 如果服务未启动,优先使用重新打包后的 jar:
|
||||
|
||||
```bash
|
||||
JAVA_HOME=/opt/homebrew/opt/openjdk@21 mvn -pl platform-app -am install -DskipTests
|
||||
/opt/homebrew/opt/openjdk@21/bin/java -jar platform-app/target/platform-app-0.1.0-SNAPSHOT.jar --spring.profiles.active=local
|
||||
```
|
||||
|
||||
## 禁止事项
|
||||
|
||||
- 不在用户原始任务目录中直接改动或启动长时间任务,除非用户明确要求。
|
||||
- 不把线上环境设置为默认写入目标。
|
||||
- 不跳过 JDK 版本检查。
|
||||
|
||||
39
docs/skills/eip4-release-manage.md
Normal file
39
docs/skills/eip4-release-manage.md
Normal file
@@ -0,0 +1,39 @@
|
||||
# Skill: eip4-release-manage
|
||||
|
||||
## 触发场景
|
||||
|
||||
- 用户要求生成部署包。
|
||||
- 用户要求发布 AI 生成的功能。
|
||||
- 用户要求线上 bug 修复或回滚。
|
||||
|
||||
## 当前边界
|
||||
|
||||
当前 `platform-ai` 只生成线上人工部署包,不自动连接线上环境执行写操作。这是设计边界,不是功能缺失。
|
||||
|
||||
## 发布前检查
|
||||
|
||||
1. 确认本地 auto-develop 已通过。
|
||||
2. 确认部署包包含:
|
||||
- manifest
|
||||
- SQL 草案
|
||||
- rollback SQL
|
||||
- 本地 apply evidence
|
||||
- smoke evidence
|
||||
- repair evidence
|
||||
3. 确认部署包需要人工审批。
|
||||
4. 如果包含 `${parentMenuId}` 等占位符,必须人工替换并复核。
|
||||
|
||||
## 线上 bug 修复路径
|
||||
|
||||
1. 收集线上错误日志、请求样本或人工复现步骤。
|
||||
2. 在本地创建新的 AI 修复任务。
|
||||
3. 本地执行 apply/smoke/repair。
|
||||
4. 生成新的部署包。
|
||||
5. 人工审核后走现有上线流程。
|
||||
|
||||
## 禁止事项
|
||||
|
||||
- 不让 Agent 默认直接写线上数据库。
|
||||
- 不绕过部署包和人审。
|
||||
- 不把 smoke 失败的变更包交给发布流程。
|
||||
|
||||
Reference in New Issue
Block a user