Files
eip4-platform/docs/skills
zhengwr 0e457d9945 feat(cli): agent 接入补全(token/MCP/REST 分流)+ 修 page-recipe recipe-id
- fix: page-recipe 的 maintenance-crud 漏 `-v1`,而 compile 端点精确匹配
  maintenance-crud-v1,agent 照抄示例会 400;统一为 -v1,并引导以
  GET /api/ai/page-recipes 为权威列表,避免硬写字面量漂移。
- env-manage 新增「鉴权/Token」段:非 prod profile permitAll 免 token,
  prod/JWT 环境需 POST /api/auth/login 取顶层 `token` + `Authorization: Bearer`
  (核实 AuthController/JwtAuthFilter)。
- AGENTS.md(writeAgentsMd):把「优先 platform-cli」误导修为按类分流
  (env/ai/release 用 CLI,建模/页面/授权用 REST 或 platform-mcp),
  并点名 platform-mcp 注册方式 + token 获取指引。
- data-modeling/page-recipe/acl-manage 各加调用方式与 token 交叉引用。
- 测试 +3:page-recipe recipe-id 回归、AGENTS.md MCP/auth、bundled skills 防漂移。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-23 09:50:23 +08:00
..

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 部署包、人审、发布前校验和回滚边界
eip4-data-modeling 建实体/加字段/引用列/主子表(/api/meta/entity)
eip4-page-recipe 用 recipe 生成默认页:维护/树/主子表(/api/design/recipe/compile)
eip4-acl-manage 菜单/角色/用户组授权(/api/admin/*)

快速接入(一键安装)

用 eip4 init 把这些 skills 安装到目标项目,供 Claude Code / Codex / OpenCode 直接读取。skill 示例里的 base URL 会按当前环境自动渲染(不再硬编码 8084/8093):

# 可选:先登记环境地址(init 会用 current env 渲染示例端口)
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar env add \
  --name local --base-url http://localhost:8094 --use

# 一键安装 skills + 生成 AGENTS.md
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar init --base-url http://localhost:8094

# 然后在该目录启动你的 agent
cd <project> && claude

产出:

  • .claude/skills/<name>/SKILL.md:Claude Code 原生 skill(自带 frontmatter)。
  • AGENTS.md:Codex / OpenCode 共用入口,内容受 EIP4-SKILLS 标记块管理(块外内容不动,可重复执行)。块内内嵌每个 skill 的完整正文,因此 Codex / OpenCode 只读 AGENTS.md 即可拿到全部规程,不依赖 .claude/skills/。

参数:--dir 目标项目根(默认当前目录)、--base-url 或 --env 指定渲染地址、--skills-dir 用本地目录覆盖内置 skills。skills 已随 platform-cli jar 一起打包,init 默认从 jar 内读取,无需仓库在场。

查看与校验已安装的 skills:

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 用法:

mvn -pl platform-mcp package
claude mcp add eip4 -- java -jar platform-mcp/target/platform-mcp-0.1.0-SNAPSHOT.jar --base-url http://localhost:8094
# 或设环境变量 EIP4_BASE_URL;默认 http://localhost:8084

工具忠实转发到平台 REST,复用人审红线(产物恒 READY_FOR_HUMAN_REVIEW)与 access-check;MCP server 应只配本地/开发 baseUrl,不另开权限面。

通用原则

  1. 优先使用 platform-cli,其次使用公开 REST API,最后才考虑人工 SQL。
  2. 默认只允许本地开发和测试环境自动执行写操作。
  3. 线上环境只能生成部署包和校验证据,不能由 Agent 默认直接写入。
  4. 每次自动开发必须保留 request、draft、change-set、apply、smoke、repair、deployment package evidence。
  5. 任何失败先回到本地复现和修复,再重新生成部署包。