Files
eip4-platform/docs/skills/eip4-page-recipe.md
zhengwr 8a6c94ebde 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>
2026-06-22 14:47:31 +08:00

45 lines
1.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 校验。