- 新增 platform-mcp 模块(stdio MCP server,MCP Java SDK 1.1.0 / jackson2 路线) - 注册 7 个 MCP 工具:eip4_auto_develop / list_page_recipes / validate_page_schema / list_components / access_check / list_entities / entity_attributes 忠实转发 EIP4 REST,复用人审红线(产物恒 READY_FOR_HUMAN_REVIEW),不另开权限面 - 工具逻辑 TDD(Eip4McpTools 9 单测,注入 mock REST client) - 真实 stdio JSON-RPC e2e:initialize 协商 + tools/list 返回 7 工具(schema 正确) + tools/call 链路(死端口优雅 isError) - 坑:父 pom 为 amis 校验钉死 networknt 1.5.2,与 MCP 需要的 2.0.0(含 dialect.Dialects) 冲突 → platform-mcp 显式覆盖 2.0.0(仅本模块) - 文档:GAP 标记 G2 完成、平台 README + skills/README 加 MCP 接入说明 接入:claude mcp add eip4 -- java -jar platform-mcp/target/platform-mcp-0.1.0-SNAPSHOT.jar --base-url <env> Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
55 lines
3.0 KiB
Markdown
55 lines
3.0 KiB
Markdown
# 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 init` 把这些 skills 安装到目标项目,供 Claude Code / Codex / OpenCode 直接读取。skill 示例里的 base URL 会按当前环境自动渲染(不再硬编码 8084/8093):
|
||
|
||
```bash
|
||
# 可选:先登记环境地址(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 内读取,无需仓库在场。
|
||
|
||
## 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 用法:
|
||
|
||
```bash
|
||
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. 任何失败先回到本地复现和修复,再重新生成部署包。
|