feat(cli): eip4 skills list/check + 3 个新 agent skill (G3)
- 新增 skill(均基于源码核实过的端点): - eip4-data-modeling — /api/meta/entity 建实体/加字段/引用列/主子表 - eip4-page-recipe — /api/design/recipe/compile 生成默认页(维护/树/主子表) - eip4-acl-manage — /api/admin/* 菜单/角色/用户组授权 manifest.json + jar 打包同步,docs/skills 现共 6 个 - CLI 新增 eip4 skills list(列内置 skills)+ skills check --dir(缺失退出非 0) - TDD 2 个新测试,platform-cli 共 22 单测全绿 - 真实验证:skills list 列 6 个 / init 装 6 个 / skills check 全 installed(exit 0)/ 端口渲染零占位符残留 - serviceflow-diagnose 暂缓:平台无「查看/诊断服务流定义」的 agent 可操作端点(需先补端点) Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -9,6 +9,9 @@
|
||||
| `eip4-env-manage` | 环境探测、启动检查、端口和 profile 边界 |
|
||||
| `eip4-ai-feature-development` | 从自然语言需求生成实体、服务流、页面、菜单和本地 smoke |
|
||||
| `eip4-release-manage` | 部署包、人审、发布前校验和回滚边界 |
|
||||
| `eip4-data-modeling` | 建实体/加字段/引用列/主子表(/api/meta/entity) |
|
||||
| `eip4-page-recipe` | 用 recipe 生成默认页:维护/树/主子表(/api/design/recipe/compile) |
|
||||
| `eip4-acl-manage` | 菜单/角色/用户组授权(/api/admin/*) |
|
||||
|
||||
## 快速接入(一键安装)
|
||||
|
||||
@@ -33,6 +36,15 @@ cd <project> && claude
|
||||
|
||||
参数:`--dir` 目标项目根(默认当前目录)、`--base-url` 或 `--env` 指定渲染地址、`--skills-dir` 用本地目录覆盖内置 skills。skills 已随 `platform-cli` jar 一起打包,`init` 默认从 jar 内读取,无需仓库在场。
|
||||
|
||||
查看与校验已安装的 skills:
|
||||
|
||||
```bash
|
||||
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar skills list
|
||||
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar skills check --dir <project>
|
||||
```
|
||||
|
||||
`skills check` 在目标项目缺少任一内置 skill 时退出码非 0,便于在 CI/接入脚本里把关。
|
||||
|
||||
## MCP 接入(标准协议)
|
||||
|
||||
除 skills + CLI 外,EIP4 还提供 MCP server(`platform-mcp`,stdio),把 `eip4_auto_develop / eip4_list_page_recipes / eip4_validate_page_schema / eip4_list_components / eip4_access_check / eip4_list_entities / eip4_entity_attributes` 暴露为 MCP 工具,让 Agent 用标准协议调用,而不必死记 CLI/REST 用法:
|
||||
|
||||
30
docs/skills/eip4-acl-manage.md
Normal file
30
docs/skills/eip4-acl-manage.md
Normal file
@@ -0,0 +1,30 @@
|
||||
# Skill: eip4-acl-manage
|
||||
|
||||
## 触发场景
|
||||
|
||||
- 给角色授菜单、管理用户组 / 角色成员、查看菜单树。
|
||||
|
||||
## 菜单
|
||||
|
||||
- `GET {{EIP4_BASE_URL}}/api/admin/menu-all` — 管理视角全量菜单树(`roots[]` 两级,含 `templateId`)。
|
||||
- `GET {{EIP4_BASE_URL}}/api/menu` — 当前用户可见菜单树。
|
||||
- `GET {{EIP4_BASE_URL}}/api/admin/user/{userId}/menu` — 指定用户可见菜单。
|
||||
- 菜单写:`POST {{EIP4_BASE_URL}}/api/admin/menus/create`、`/api/admin/menus/{id}/update`、`/api/admin/menus/{id}/delete`。
|
||||
|
||||
## 角色授权
|
||||
|
||||
- `POST {{EIP4_BASE_URL}}/api/admin/roles/{id}/set-menus`,body `{"menuIds": ["..."]}`(整存差量,空数组=清空)。
|
||||
- `GET {{EIP4_BASE_URL}}/api/admin/roles/{roleId}/users` — 角色成员。
|
||||
|
||||
## 用户 / 用户组
|
||||
|
||||
- `GET {{EIP4_BASE_URL}}/api/admin/users?page=1&perPage=20&keyword=` — 用户分页(密码列不下发)。
|
||||
- `POST {{EIP4_BASE_URL}}/api/admin/usergroups/create`,body `{"name","description"}`。
|
||||
- `POST {{EIP4_BASE_URL}}/api/admin/usergroups/{id}/update | /delete`。
|
||||
- `POST {{EIP4_BASE_URL}}/api/admin/usergroups/{id}/add-user | /remove-user`(幂等)。
|
||||
- `POST {{EIP4_BASE_URL}}/api/admin/usergroups/{id}/add-role | /remove-role`。
|
||||
|
||||
## 红线
|
||||
|
||||
- 写操作仅管理员,事务性。
|
||||
- 授权走「用户组 → 角色 → 菜单」链(`sys_usergrouprole` / `sys_usergroupuser`),不直接给单用户授菜单。
|
||||
53
docs/skills/eip4-data-modeling.md
Normal file
53
docs/skills/eip4-data-modeling.md
Normal file
@@ -0,0 +1,53 @@
|
||||
# Skill: eip4-data-modeling
|
||||
|
||||
## 触发场景
|
||||
|
||||
- 用户要新建业务实体(表)、给已有表加字段。
|
||||
- 需要引用列(外键)、主子表结构。
|
||||
|
||||
## 端点
|
||||
|
||||
建实体:`POST {{EIP4_BASE_URL}}/api/meta/entity`
|
||||
|
||||
```json
|
||||
{
|
||||
"tablename": "EIP4AI_DEMO",
|
||||
"name": "演示实体",
|
||||
"attributes": [
|
||||
{"column": "TITLE", "display": "标题", "type": "string", "length": 200, "mandatory": true},
|
||||
{"column": "OWNER", "display": "负责人", "type": "reference", "referenceTable": "SYS_USER"}
|
||||
],
|
||||
"tabletype": 0,
|
||||
"masterTable": "PARENT_TABLE"
|
||||
}
|
||||
```
|
||||
|
||||
- `tablename` 必须 EIP4 前缀,大写,匹配 `[A-Z][A-Z0-9_]{2,40}`。
|
||||
- `type`:`string | integer | number | date | datetime | boolean | reference`。
|
||||
- `reference` 必带 `referenceTable`,自动生成 CHAR(36) 外键列指向目标表。
|
||||
- `tabletype`:`0`=主表 `1`=子表 `2`=中间表;子表用 `masterTable` 指定主表,自动加 `MASTERID` 回链列。
|
||||
- 标准列(主键/版本/审计时间/操作人)由引擎自动补齐,**不要手传**。
|
||||
|
||||
加字段:`POST {{EIP4_BASE_URL}}/api/meta/entity/{table}/attributes`,body 为 `{"attributes":[...]}`。
|
||||
- ALTER ADD COLUMN 恒可空(有数据的表加 NOT NULL 会失败)。
|
||||
|
||||
查询:
|
||||
- `GET {{EIP4_BASE_URL}}/api/meta/entities` — 实体目录(引用列目标表选择)。
|
||||
- `GET {{EIP4_BASE_URL}}/api/meta/entity/{table}` — 单实体属性(columns + displayColumn)。
|
||||
- `GET {{EIP4_BASE_URL}}/api/meta/entity-types` — 实体分类。
|
||||
|
||||
删除:`DELETE {{EIP4_BASE_URL}}/api/meta/entity/{table}`(仅 EIP4 前缀表)。
|
||||
|
||||
## 命令示例
|
||||
|
||||
```bash
|
||||
curl -X POST {{EIP4_BASE_URL}}/api/meta/entity \
|
||||
-H "Content-Type: application/json" \
|
||||
--data-binary @entity.json
|
||||
```
|
||||
|
||||
## 红线
|
||||
|
||||
- 表名必须 EIP4 前缀,DDL 经 CreateTableSqlGuard / AlterTableSqlGuard / DropTableSqlGuard 强制校验。
|
||||
- 建表/加列/删表只对 EIP4 前缀表;生产表禁碰。
|
||||
- 不手传标准审计列。
|
||||
44
docs/skills/eip4-page-recipe.md
Normal file
44
docs/skills/eip4-page-recipe.md
Normal file
@@ -0,0 +1,44 @@
|
||||
# Skill: eip4-page-recipe
|
||||
|
||||
## 触发场景
|
||||
|
||||
- 用户要为某实体生成默认页面(维护 / 树 / 主子表)。
|
||||
- 需要派生列、父级汇总。
|
||||
|
||||
## recipe 类型
|
||||
|
||||
- `maintenance-crud` — 普通维护 CRUD(列表 + 表单)。
|
||||
- `tree-crud-v1` — 树形维护(有 parentid 的层级表)。
|
||||
- `master-detail-v1` — 主子表(主表 + 子表行内编辑)。
|
||||
|
||||
## 端点
|
||||
|
||||
编译生成默认页:`POST {{EIP4_BASE_URL}}/api/design/recipe/compile`
|
||||
|
||||
```json
|
||||
{
|
||||
"tableName": "EIP4_DEMO",
|
||||
"title": "演示页面",
|
||||
"recipe": "maintenance-crud",
|
||||
"pageSize": 20,
|
||||
"displayField": "NAME",
|
||||
"childTable": "DEMO_DETAIL",
|
||||
"linkColumn": "MASTERID",
|
||||
"childDerived": [{"column": "AMOUNT", "formula": "QTY*PRICE"}],
|
||||
"childRollup": [{"masterColumn": "TOTAL", "childColumn": "AMOUNT", "agg": "SUM"}]
|
||||
}
|
||||
```
|
||||
|
||||
- `childTable` / `linkColumn` 仅 `master-detail-v1` 需要;`childDerived` / `childRollup` 可选。
|
||||
- 生成流程:读实体属性 → 装配编译 → typed schema 严格校验(不过则 400)→ 落标准层(页面唯一真相)。
|
||||
- 返回 `data.templateId`。
|
||||
|
||||
查可用 recipe(经 AI 链路):`GET {{EIP4_BASE_URL}}/api/ai/page-recipes`。
|
||||
|
||||
校验页面 schema(不写库):`POST {{EIP4_BASE_URL}}/api/page/schema/validate`。
|
||||
组件能力表:`GET {{EIP4_BASE_URL}}/api/page/schema/components`。
|
||||
|
||||
## 红线
|
||||
|
||||
- schema 只能使用注册过的组件 / 动作;typed 校验会拒未注册组件或不支持的 actionType。
|
||||
- 生成 = 落标准层;设计器 overlay 在其上叠加,二者共用同一份 typed schema 校验。
|
||||
Reference in New Issue
Block a user