feat(cli): eip4 init 一键接入 Claude Code/Codex/OpenCode (G1)
- 新增 eip4 init:把 agent skills 装到目标项目
- Claude Code → .claude/skills/<name>/SKILL.md(代码生成 frontmatter)
- Codex/OpenCode → 根 AGENTS.md(EIP4-SKILLS 标记块,内嵌 skill 全文,块外保留,幂等)
- base URL 按 --base-url/--env/current env 渲染
- docs/skills/*.md 的 base URL 改为 {{EIP4_BASE_URL}} 占位符
- 新增 eip4-skills/manifest.json + pom 用 maven-resources-plugin 把 docs/skills 打进 jar(init 默认从 classpath 读,无需仓库在场)
- 文档:AI_AGENT_Nocobase_INTEGRATION_GAP_AND_PLAN(NocoBase 对照 + G1-G3 计划)、skills/README、平台 README
- TDD 5 个新测试,platform-cli 共 20 单测全绿;真实 jar 端到端验证通过
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -13,7 +13,7 @@ EIP4 平台正式工程(路线 A'):双层制模块化单体——**保真层供
|
||||
| platform-converter | 模板转换器(P4) | 可独立 CLI 跑批 |
|
||||
| platform-flow-gateway | P3 占位:Flowable 网关 | |
|
||||
| platform-ai | P5 AI Agent 开发底座:草稿/变更包/本地门禁/自动修复/人工部署包 | Agent 不直连线上执行生产变更 |
|
||||
| platform-cli | EIP4 Agent 受控命令入口:环境探测、AI 自动开发、后续发布编排 | Agent 优先通过 CLI/API 操作 |
|
||||
| platform-cli | EIP4 Agent 受控命令入口:`init` 一键接入(Claude Code/Codex/OpenCode)、环境探测、AI 自动开发、发布编排 | Agent 优先通过 CLI/API 操作 |
|
||||
| platform-parity | C1 对拍框架:录制/重放/RowDiff/自对拍 CLI | P1 一级交付物 |
|
||||
| platform-app | Boot 启动器,组装全部模块 | ArchUnit 规则在此模块测试里 |
|
||||
|
||||
@@ -81,6 +81,13 @@ mvn -pl platform-parity exec:java -Dexec.mainClass="com.eip4.platform.parity.sel
|
||||
mvn -pl platform-cli package
|
||||
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar env add --name local --base-url http://localhost:8084 --use
|
||||
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar env status --base-url http://localhost:8084
|
||||
|
||||
# 一键把 agent skills 装到目标项目,让 Claude Code / Codex / OpenCode 都能驱动平台开发
|
||||
# Claude Code → .claude/skills/<name>/SKILL.md(原生 skill);Codex/OpenCode → 根 AGENTS.md(内嵌全文)
|
||||
# base URL 按 current env(或 --base-url/--env)渲染;skills 已随 jar 打包,无需仓库在场
|
||||
# 详见 docs/skills/README.md
|
||||
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar init --dir <你的项目>
|
||||
|
||||
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar ai feature-package --task-id ait-xxx --change-set-id aics-xxx --output target/ai-runs/package.json
|
||||
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar release verify --package-file target/ai-runs/package.json
|
||||
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar release export --package-file target/ai-runs/package.json --output target/ai-runs/package.eip4pkg.json
|
||||
|
||||
148
docs/AI_AGENT_Nocobase_INTEGRATION_GAP_AND_PLAN.md
Normal file
148
docs/AI_AGENT_Nocobase_INTEGRATION_GAP_AND_PLAN.md
Normal file
@@ -0,0 +1,148 @@
|
||||
# EIP4 对照 NocoBase 的 AI Agent 接入差距与补齐计划
|
||||
|
||||
日期:2026-06-22
|
||||
|
||||
本文回答一个具体问题:**外部 coding agent(Claude Code / Codex / Cursor / OpenCode)接入平台做开发这件事,EIP4 和 NocoBase 现在差在哪、要补什么。**
|
||||
|
||||
口径限定:只谈「外部 agent 驱动确定性开发」这条线(EIP4 称 ①面)。平台内置生成式 LLM(②面)受对外承诺红线约束,单列在「四、不做的部分」,本文不展开。
|
||||
|
||||
前序文档:
|
||||
- `AI_AGENT_Nocobase_ADOPTION_PLAN.md`(2026-06-17 借鉴路线,P0–P5)
|
||||
- `AI_AGENT_Nocobase_SOURCE_REVIEW.md`(2026-06-17 源码级对照)
|
||||
- 本文是上述两份在「接入体验」维度的增量,已对齐 NocoBase 2026 现状(AI employees 加 Skills、新增 MCP server plugin)。
|
||||
|
||||
NocoBase 参考:
|
||||
- AI Builder:https://docs.nocobase.com/ai-builder/
|
||||
- Skills 仓库:https://github.com/nocobase/skills
|
||||
- AI Employees / MCP:https://docs.nocobase.com/ai-employees/ ,https://docs.nocobase.com/ai-employees/features/mcp
|
||||
- LLM Service:https://v2.docs.nocobase.com/ai-employees/features/llm-service
|
||||
|
||||
---
|
||||
|
||||
## 一、一句话结论
|
||||
|
||||
EIP4 和 NocoBase 的**核心判断一致**:AI 不从零生成代码,而是在已过生产验证的 no-code 底座上操作元数据/页面/流程,人审控制生产变更。EIP4 ①面 v1 已交付、骨架完整;**差距全在「接入体验」而非「架构方向」**:NocoBase 把接入做成了一键安装 + 标准 MCP 协议,EIP4 还停在「手动喂 md + agent 死记 CLI」。补齐这层,EIP4 的外部 agent 接入即可达到 NocoBase 同等顺滑度。
|
||||
|
||||
---
|
||||
|
||||
## 二、现状对照(带证据)
|
||||
|
||||
### EIP4 已有的接入资产(基线)
|
||||
|
||||
| 资产 | 证据 | 状态 |
|
||||
|---|---|---|
|
||||
| 确定性生成主链路 | `platform-ai/.../service/AiFeatureDraftGenerator.java`、`AiAgentService.java`、`AiLocalReleaseExecutor.java` | ✅ 已合 main |
|
||||
| CLI(可运行 jar) | `platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar`;命令族 `env` / `ai` / `release` | ✅ |
|
||||
| Skills 规程 | `docs/skills/`:`README.md` + `eip4-env-manage` + `eip4-ai-feature-development` + `eip4-release-manage` | ⚠️ 仅 4 个,且只是仓库文档 |
|
||||
| REST API | `/api/ai/*`、`/api/design/*`、`/api/meta/*`、`/api/page/schema/{components,validate,overlay}` | ✅ |
|
||||
| Typed schema 门禁 | `POST /api/page/schema/validate`、overlay 保存前强制校验 | ✅ |
|
||||
| AI 工具/权限注册表 | `GET /api/ai/tools`、`/api/ai/employees`、`POST /api/ai/tools/access-check` | ✅(注册表层,非运行时调度)|
|
||||
| 人审红线 | `AiDeploymentPackage.requiresHumanApproval=true`、状态恒 `READY_FOR_HUMAN_REVIEW` | ✅ |
|
||||
| 版本/回滚 | `eip4 ai revision`、`eip4 release rollback-plan`(只生成计划不执行)| ✅ |
|
||||
|
||||
### EIP4 CLI 命令清单(核实自 `Eip4Cli.java`)
|
||||
|
||||
```
|
||||
eip4 env add | list | use | current | status
|
||||
eip4 ai auto-develop | feature-package | revision
|
||||
eip4 release diff | export | import-preview | rollback-plan | verify
|
||||
```
|
||||
**注意:没有 `init`,也没有 `skills install/check/update`。** 这是和 NocoBase 的关键体验差。
|
||||
|
||||
### 逐项对照
|
||||
|
||||
| 维度 | NocoBase(2026 现状) | EIP4(现状) | 差距 |
|
||||
|---|---|---|---|
|
||||
| 核心理念:AI 在 no-code 底座工作、不从零生成 | ✅ | ✅ | 无(同源)|
|
||||
| 外部 agent 接入门槛 | `nb init --ui` **自动安装 ~13 个 Skills**,`cd && claude` 直连 | 需人工把 `docs/skills/*.md` 复制/引用给 agent | **大** → G1 |
|
||||
| Skills 覆盖面 | ~13:env / data-modeling / ui-builder / workflow / acl / plugin-manage / publish / revision / plugin-dev / data-analysis … | 4:env / ai-feature / release | **中** → G3 |
|
||||
| Skills 安装与校验 | CLI 安装/检查/更新(`skills install`)| 无,纯仓库文档 | 中 → G3 |
|
||||
| MCP server(外部 AI 用标准协议操作平台)| ✅ 已有 MCP server plugin(2026 新增)| ❌ 仅 `AiArtifactType.java:6` 一行注释 | **大** → G2 |
|
||||
| CLI 命令族 | `nb` env/pm/revision/publish | `eip4` env/ai/release | 小(基本对齐)|
|
||||
| 人审确认 | Skill Permission(Ask / Allow)| `READY_FOR_HUMAN_REVIEW` + `requiresHumanApproval` | 无(机制等价)|
|
||||
| 版本/回滚 | `nb revision` | `eip4 ai revision` / `release rollback-plan` | 无 |
|
||||
| 端口/连接配置一致性 | `nb init` 引导写入 | skills 文档写 `8084`,实际环境跑 `8093/8094` | **小但扎手** → G1 |
|
||||
| 内置 LLM / AI employees(②面)| ✅ 接 OpenAI/Claude/Gemini/DeepSeek/Qwen/Ollama | ❌ 刻意不做(repair 钩子默认关)| 受红线约束 → 见「四」|
|
||||
|
||||
---
|
||||
|
||||
## 三、补齐计划(按对外接入体验优先级)
|
||||
|
||||
### G1 — 一键接入体验(P0,最快见效)✅ 已完成(2026-06-22)
|
||||
|
||||
**问题**:接入要人工搬运 md + agent 不知道端口,第一步就劝退。
|
||||
|
||||
**做什么**:
|
||||
1. 新增 `eip4 init`(或独立脚本 `scripts/install-skills.sh`),把 `docs/skills/*.md` 安装到各 agent 能自动读取的位置:
|
||||
- Claude Code:`.claude/skills/`(或写入项目 `CLAUDE.md` 引用块)
|
||||
- Codex:项目根 `AGENTS.md`
|
||||
- OpenCode:其 agent 规则/上下文目录
|
||||
2. 安装时把 skills 里的 `--base-url` 占位符**用当前 env registry 的 current env 渲染**(解决 `8084` vs `8093/8094` 不一致)。
|
||||
3. 安装完打印「下一步:`cd <dir> && claude`」引导,对齐 NocoBase 体验。
|
||||
|
||||
**验收**:
|
||||
- 一条命令后,新开 Claude Code 会话能识别 `eip4-ai-feature-development` skill,并据此跑通 `eip4 ai auto-develop` 产出 `READY_FOR_HUMAN_REVIEW` 包。
|
||||
- skills 文档内端口与实际启动端口一致,agent 不再连错。
|
||||
|
||||
**成本**:小(1 个 CLI 子命令 + 文本渲染 + 端口统一)。
|
||||
|
||||
**落地(2026-06-22)**:`eip4 init` 已实现于 `platform-cli`(`Eip4Cli.runInit`),TDD 4 个新测试 + 原有共 19 单测全绿。配套:`docs/skills/*.md` 的 base URL 改为 `{{EIP4_BASE_URL}}` 占位符;新增 `platform-cli/src/main/resources/eip4-skills/manifest.json`(skill 清单 + name/description);`pom.xml` 用 maven-resources-plugin 把 `docs/skills` 打进 jar。真实 jar 端到端验证通过:`init` 产出 `.claude/skills/<name>/SKILL.md`(带 frontmatter)+ 根 `AGENTS.md`(`EIP4-SKILLS` 标记块,块外内容保留、可重复执行,且**内嵌每个 skill 渲染后全文**——Claude Code 用 `.claude/skills/` 原生 skill,Codex/OpenCode 读 `AGENTS.md` 即得完整规程,三工具全覆盖),base URL 按 `--base-url`/`--env`/current env 渲染,零占位符残留。skills 随 jar 打包,`init` 默认从 classpath 读取,无需仓库在场。
|
||||
|
||||
### G2 — MCP server(P1,接入面标准化)
|
||||
|
||||
**问题**:现在 agent 要靠 skill 文档「死记」CLI/REST 用法;NocoBase 已用 MCP 把能力做成可发现、可调用的标准工具。
|
||||
|
||||
**做什么**:起一个 **EIP4 MCP server** 最小骨架,把已有端点包成 MCP tools(stdio + streamable HTTP 两种 transport,对齐 NocoBase):
|
||||
- `eip4.auto_develop` → `POST /api/ai/features/auto-develop`
|
||||
- `eip4.list_page_recipes` → `GET /api/ai/page-recipes`
|
||||
- `eip4.validate_page_schema` → `POST /api/page/schema/validate`
|
||||
- `eip4.list_components` → `GET /api/page/schema/components`
|
||||
- `eip4.access_check` → `POST /api/ai/tools/access-check`
|
||||
- (只读)`eip4.list_entities` / `eip4.entity_attributes` → `/api/meta/*`
|
||||
|
||||
红线沿用:所有写工具走本地 env;生产写默认阻断;产物恒 `READY_FOR_HUMAN_REVIEW`。MCP 工具粒度 1:1 复用现有 `AiToolRegistry` 的 scope 与 `access-check`,不新开权限面。
|
||||
|
||||
**验收**:
|
||||
- Claude Code / Codex 通过 MCP 连上后 `list tools` 能看到上述 eip4 工具。
|
||||
- 通过 MCP 调 `eip4.auto_develop` 能产出待人审部署包,证据与 CLI 路径一致。
|
||||
|
||||
**成本**:中(一个独立 server 进程;建议先 stdio + 复用 REST,不重写业务)。
|
||||
|
||||
### G3 — Skills 覆盖面 + 安装/检查(P1)
|
||||
|
||||
**问题**:4 个 skill 覆盖不到「建模/选 recipe/权限/服务流诊断」等高频动作,agent 仍要猜。
|
||||
|
||||
**做什么**:
|
||||
1. 补 skills(对标 NocoBase 但只覆盖 EIP4 真实能力,不照搬不存在的功能):
|
||||
- `eip4-data-modeling`(建实体/字段/引用列,映射 `/api/meta/entity`)
|
||||
- `eip4-page-recipe`(三种 recipe:maintenance-crud-v1 / tree-crud-v1 / master-detail-v1 的选用与字段约束)
|
||||
- `eip4-acl-manage`(菜单授权/角色,映射 `/api/admin/*`)
|
||||
- `eip4-serviceflow-diagnose`(默认流生成与排错)
|
||||
2. 给 CLI 加 `eip4 skills list/check`,校验本地已安装 skill 版本与仓库是否一致。
|
||||
|
||||
**验收**:agent 不再询问「表怎么建 / recipe 怎么选 / 权限怎么配」即可独立完成一个新功能。
|
||||
|
||||
**成本**:中(主要是文档 + 一个 CLI 校验命令)。
|
||||
|
||||
---
|
||||
|
||||
## 四、不做的部分(红线)
|
||||
|
||||
- **平台不内置生成式 LLM(②面)**:NocoBase 做了内置 AI employees + LLM Service(OpenAI/Claude/Gemini/DeepSeek/Qwen/Ollama)。EIP4 进程内唯一 LLM 是 `HttpAiLlmRepairClient`,`@ConditionalOnProperty(...repair.enabled,"true")` **默认关,且只修不生成**。是否立②面 = v1 之后的产品决策,本文不推进。
|
||||
- **终点恒人审**:任何接入路径产物都停在 `READY_FOR_HUMAN_REVIEW`,生产写默认阻断。G1–G3 不得绕过该门禁。
|
||||
- **对外口径**:限「AI 辅助、人工复核」;严禁承诺「AI 全自动开发 / 人力大幅下降」(决策会纪要商务条款③)。
|
||||
|
||||
---
|
||||
|
||||
## 五、建议执行顺序
|
||||
|
||||
1. **G1 一键接入**(P0,半天级):投入最小、最快让 claude code/codex 真正能用上 EIP4。
|
||||
2. **G2 MCP server 最小骨架**(P1):把接入面标准化,去掉「agent 死记用法」。
|
||||
3. **G3 Skills 补全**(P1,可与 G2 并行):提升 agent 自主完成度。
|
||||
4. ②面(内置 LLM)维持观望,待产品对红线拍板。
|
||||
|
||||
---
|
||||
|
||||
## 六、与既有路线图的关系
|
||||
|
||||
本文 G1–G3 落在 `AI_AGENT_Nocobase_ADOPTION_PLAN.md` 的 P1(受控入口/Skills)与 P5(MCP 白名单)之间,是把当时「第一版完成」的接入层提升到 NocoBase 2026 的体验基线。`SOURCE_REVIEW.md` P5 未完成项明确列了「MCP 工具白名单」「Skills CLI check/update」——本文 G2/G3 即其落地化。进度以 `项目进度与路线-总览-2026-06-21.md` 为准,落地后回写该总览。
|
||||
@@ -10,6 +10,29 @@
|
||||
| `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 内读取,无需仓库在场。
|
||||
|
||||
## 通用原则
|
||||
|
||||
1. 优先使用 `platform-cli`,其次使用公开 REST API,最后才考虑人工 SQL。
|
||||
|
||||
@@ -37,7 +37,7 @@ ENABLED:启用:boolean::false
|
||||
|
||||
```bash
|
||||
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar ai auto-develop \
|
||||
--base-url http://localhost:8084 \
|
||||
--base-url {{EIP4_BASE_URL}} \
|
||||
--objective "新增客户等级维护功能" \
|
||||
--feature-name "客户等级维护" \
|
||||
--table-name EIP4AI_CUSTOMER_LEVEL \
|
||||
@@ -56,7 +56,7 @@ java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar ai auto-develop \
|
||||
|
||||
```bash
|
||||
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar ai auto-develop \
|
||||
--base-url http://localhost:8084 \
|
||||
--base-url {{EIP4_BASE_URL}} \
|
||||
--objective "新增组织分类树形维护功能" \
|
||||
--feature-name "组织分类维护" \
|
||||
--table-name EIP4AI_ORG_CATEGORY \
|
||||
@@ -83,9 +83,9 @@ java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar ai auto-develop \
|
||||
## 页面 schema 校验
|
||||
|
||||
```bash
|
||||
curl http://localhost:8084/api/page/schema/components
|
||||
curl {{EIP4_BASE_URL}}/api/page/schema/components
|
||||
|
||||
curl -X POST http://localhost:8084/api/page/schema/validate \
|
||||
curl -X POST {{EIP4_BASE_URL}}/api/page/schema/validate \
|
||||
-H "Content-Type: application/json" \
|
||||
--data-binary @target/ai-runs/page-schema.json
|
||||
```
|
||||
@@ -95,10 +95,10 @@ curl -X POST http://localhost:8084/api/page/schema/validate \
|
||||
## AI 工具权限检查
|
||||
|
||||
```bash
|
||||
curl http://localhost:8084/api/ai/tools
|
||||
curl http://localhost:8084/api/ai/employees
|
||||
curl {{EIP4_BASE_URL}}/api/ai/tools
|
||||
curl {{EIP4_BASE_URL}}/api/ai/employees
|
||||
|
||||
curl -X POST http://localhost:8084/api/ai/tools/access-check \
|
||||
curl -X POST {{EIP4_BASE_URL}}/api/ai/tools/access-check \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{"employeeId":"agent-developer","toolName":"local.apply","grantedScopes":["ai:local:apply"],"targetEnv":"local","productionWrite":false}'
|
||||
```
|
||||
|
||||
@@ -10,15 +10,13 @@
|
||||
|
||||
1. 确认当前目录是否是独立 worktree,避免污染用户正在做的任务。
|
||||
2. 使用 JDK 21,不能使用 JDK 26。
|
||||
3. 默认本地 profile:
|
||||
- `local`: `http://localhost:8084`
|
||||
- `dev`: `http://localhost:8093`
|
||||
3. 默认本地 base URL 由 `eip4 init` 渲染,当前环境为 `{{EIP4_BASE_URL}}`;多套环境用 `eip4 env add/use` 管理。
|
||||
4. 使用 CLI 探测环境:
|
||||
|
||||
```bash
|
||||
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar env add \
|
||||
--name local \
|
||||
--base-url http://localhost:8084 \
|
||||
--base-url {{EIP4_BASE_URL}} \
|
||||
--kind local \
|
||||
--use
|
||||
|
||||
|
||||
@@ -17,7 +17,7 @@
|
||||
|
||||
```bash
|
||||
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar ai feature-package \
|
||||
--base-url http://localhost:8084 \
|
||||
--base-url {{EIP4_BASE_URL}} \
|
||||
--task-id ait-xxx \
|
||||
--change-set-id aics-xxx \
|
||||
--output target/ai-runs/feature-package.json
|
||||
@@ -27,7 +27,7 @@ java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar ai feature-package
|
||||
|
||||
```bash
|
||||
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar ai revision \
|
||||
--base-url http://localhost:8084 \
|
||||
--base-url {{EIP4_BASE_URL}} \
|
||||
--task-id ait-xxx \
|
||||
--package-id aipkg-xxx \
|
||||
--note "本地门禁通过,待人工部署" \
|
||||
|
||||
@@ -51,6 +51,33 @@
|
||||
</execution>
|
||||
</executions>
|
||||
</plugin>
|
||||
<plugin>
|
||||
<groupId>org.apache.maven.plugins</groupId>
|
||||
<artifactId>maven-resources-plugin</artifactId>
|
||||
<executions>
|
||||
<execution>
|
||||
<id>copy-agent-skills</id>
|
||||
<phase>process-resources</phase>
|
||||
<goals>
|
||||
<goal>copy-resources</goal>
|
||||
</goals>
|
||||
<configuration>
|
||||
<outputDirectory>${project.build.outputDirectory}/eip4-skills</outputDirectory>
|
||||
<resources>
|
||||
<resource>
|
||||
<directory>${project.basedir}/../docs/skills</directory>
|
||||
<includes>
|
||||
<include>*.md</include>
|
||||
</includes>
|
||||
<excludes>
|
||||
<exclude>README.md</exclude>
|
||||
</excludes>
|
||||
</resource>
|
||||
</resources>
|
||||
</configuration>
|
||||
</execution>
|
||||
</executions>
|
||||
</plugin>
|
||||
</plugins>
|
||||
</build>
|
||||
</project>
|
||||
|
||||
@@ -1,6 +1,7 @@
|
||||
package com.eip4.platform.cli;
|
||||
|
||||
import java.io.IOException;
|
||||
import java.io.InputStream;
|
||||
import java.io.PrintStream;
|
||||
import java.net.URI;
|
||||
import java.nio.charset.StandardCharsets;
|
||||
@@ -60,6 +61,7 @@ public final class Eip4Cli {
|
||||
return 0;
|
||||
}
|
||||
return switch (args[0]) {
|
||||
case "init" -> runInit(args, out, err);
|
||||
case "env" -> runEnv(args, out, err);
|
||||
case "ai" -> runAi(args, out, err);
|
||||
case "release" -> runRelease(args, out, err);
|
||||
@@ -689,6 +691,119 @@ public final class Eip4Cli {
|
||||
return new CliTarget("", Eip4EnvStore.normalizeBaseUrl(value));
|
||||
}
|
||||
|
||||
private int runInit(String[] args, PrintStream out, PrintStream err) throws IOException {
|
||||
if (args.length >= 2 && isHelp(args[1])) {
|
||||
printInitHelp(out);
|
||||
return 0;
|
||||
}
|
||||
Options options = Options.parse(args, 1);
|
||||
String baseUrl = baseUrl(options);
|
||||
Path targetDir = Path.of(options.single("dir") == null ? "." : options.single("dir"));
|
||||
SkillSource source = skillSource(options.single("skills-dir"));
|
||||
|
||||
String manifestJson = source.read("manifest.json");
|
||||
if (manifestJson == null) {
|
||||
return fail(err, "找不到 skills manifest.json(--skills-dir 指向的目录或内置资源缺失)");
|
||||
}
|
||||
JsonNode manifest = objectMapper.readTree(manifestJson);
|
||||
Path claudeSkills = targetDir.resolve(".claude").resolve("skills");
|
||||
StringBuilder catalog = new StringBuilder();
|
||||
StringBuilder bodies = new StringBuilder();
|
||||
int installed = 0;
|
||||
for (JsonNode skill : manifest.path("skills")) {
|
||||
String file = skill.path("file").asText();
|
||||
String name = skill.path("name").asText();
|
||||
String description = skill.path("description").asText();
|
||||
String body = source.read(file);
|
||||
if (body == null) {
|
||||
return fail(err, "缺少 skill 文件: " + file);
|
||||
}
|
||||
String rendered = body.replace("{{EIP4_BASE_URL}}", baseUrl);
|
||||
Path skillDir = claudeSkills.resolve(name);
|
||||
Files.createDirectories(skillDir);
|
||||
String doc = "---\nname: " + name + "\ndescription: " + description + "\n---\n\n" + rendered;
|
||||
Files.writeString(skillDir.resolve("SKILL.md"), doc, StandardCharsets.UTF_8);
|
||||
catalog.append("- **").append(name).append("** — ").append(description).append('\n');
|
||||
bodies.append("\n---\n\n### Skill: ").append(name).append("\n\n").append(rendered).append('\n');
|
||||
installed++;
|
||||
}
|
||||
Path agents = writeAgentsMd(targetDir, baseUrl, catalog.toString(), bodies.toString());
|
||||
out.println("Installed " + installed + " EIP4 skill(s) for Claude Code at " + claudeSkills);
|
||||
out.println("Updated " + agents + " for Codex / OpenCode");
|
||||
out.println("baseUrl: " + baseUrl);
|
||||
out.println("Next: cd " + targetDir + " && claude");
|
||||
return 0;
|
||||
}
|
||||
|
||||
private static final String SKILLS_BEGIN = "<!-- EIP4-SKILLS:BEGIN (managed by `eip4 init`) -->";
|
||||
private static final String SKILLS_END = "<!-- EIP4-SKILLS:END -->";
|
||||
|
||||
private Path writeAgentsMd(Path targetDir, String baseUrl, String catalog, String bodies) throws IOException {
|
||||
String block = SKILLS_BEGIN + "\n"
|
||||
+ "## EIP4 平台接入(AI Agent)\n\n"
|
||||
+ "Base URL: " + baseUrl + "\n\n"
|
||||
+ "已安装 skills(Claude Code 见 `.claude/skills/`;以下内嵌完整正文,供 Codex / OpenCode 使用):\n"
|
||||
+ catalog + "\n"
|
||||
+ "通用原则:优先用 `platform-cli`,其次 REST API;本地写默认放行、生产写阻断;"
|
||||
+ "AI 产物恒为 READY_FOR_HUMAN_REVIEW,需人工复核后发布。\n"
|
||||
+ bodies
|
||||
+ SKILLS_END + "\n";
|
||||
Path agents = targetDir.resolve("AGENTS.md");
|
||||
String updated;
|
||||
if (Files.exists(agents)) {
|
||||
String existing = Files.readString(agents, StandardCharsets.UTF_8);
|
||||
int begin = existing.indexOf(SKILLS_BEGIN);
|
||||
int end = existing.indexOf(SKILLS_END);
|
||||
if (begin >= 0 && end > begin) {
|
||||
updated = existing.substring(0, begin) + block
|
||||
+ existing.substring(end + SKILLS_END.length()).replaceFirst("^\\R", "");
|
||||
} else {
|
||||
String sep = existing.isEmpty() || existing.endsWith("\n\n")
|
||||
? "" : (existing.endsWith("\n") ? "\n" : "\n\n");
|
||||
updated = existing + sep + block;
|
||||
}
|
||||
} else {
|
||||
Files.createDirectories(targetDir);
|
||||
updated = "# AGENTS\n\nEIP4 项目的 AI Agent 接入说明。\n\n" + block;
|
||||
}
|
||||
Files.writeString(agents, updated, StandardCharsets.UTF_8);
|
||||
return agents;
|
||||
}
|
||||
|
||||
private SkillSource skillSource(String skillsDir) {
|
||||
if (skillsDir != null && !skillsDir.isBlank()) {
|
||||
Path dir = Path.of(skillsDir);
|
||||
return name -> {
|
||||
Path file = dir.resolve(name);
|
||||
return Files.exists(file) ? Files.readString(file, StandardCharsets.UTF_8) : null;
|
||||
};
|
||||
}
|
||||
return name -> {
|
||||
try (InputStream in = Eip4Cli.class.getResourceAsStream("/eip4-skills/" + name)) {
|
||||
return in == null ? null : new String(in.readAllBytes(), StandardCharsets.UTF_8);
|
||||
}
|
||||
};
|
||||
}
|
||||
|
||||
@FunctionalInterface
|
||||
private interface SkillSource {
|
||||
String read(String name) throws IOException;
|
||||
}
|
||||
|
||||
private void printInitHelp(PrintStream out) {
|
||||
out.println("""
|
||||
Usage:
|
||||
eip4 init [--dir DIR] [--base-url URL|--env NAME] [--skills-dir DIR]
|
||||
|
||||
Installs EIP4 agent skills so Claude Code / Codex / OpenCode can drive
|
||||
the platform. Renders the configured base URL into the skill examples.
|
||||
--dir target project root (default: current directory)
|
||||
--base-url base URL to render (default: current env, then http://localhost:8084)
|
||||
--env use a configured env's base URL
|
||||
--skills-dir read skills from a directory instead of the bundled set
|
||||
""");
|
||||
}
|
||||
|
||||
private void ensureCrossEnvConfirmed(Options options) throws IOException {
|
||||
String envName = options.single("env");
|
||||
if (envName == null || envName.isBlank() || options.has("yes")) {
|
||||
|
||||
19
platform-cli/src/main/resources/eip4-skills/manifest.json
Normal file
19
platform-cli/src/main/resources/eip4-skills/manifest.json
Normal file
@@ -0,0 +1,19 @@
|
||||
{
|
||||
"skills": [
|
||||
{
|
||||
"file": "eip4-env-manage.md",
|
||||
"name": "eip4-env-manage",
|
||||
"description": "EIP4 环境探测、启动检查、端口与 profile 边界"
|
||||
},
|
||||
{
|
||||
"file": "eip4-ai-feature-development.md",
|
||||
"name": "eip4-ai-feature-development",
|
||||
"description": "从自然语言需求生成实体、服务流、页面、菜单并跑本地 smoke"
|
||||
},
|
||||
{
|
||||
"file": "eip4-release-manage.md",
|
||||
"name": "eip4-release-manage",
|
||||
"description": "EIP4 部署包、人审、发布前校验与回滚边界"
|
||||
}
|
||||
]
|
||||
}
|
||||
@@ -381,6 +381,133 @@ class Eip4CliTest {
|
||||
assertTrue(result.err().contains("rollbackSqlStatements 仍包含"));
|
||||
}
|
||||
|
||||
@Test
|
||||
void initRendersClaudeSkillWithRenderedBaseUrl() throws Exception {
|
||||
Path skillsDir = writeSkillsFixture();
|
||||
Path target = tempDir.resolve("proj");
|
||||
|
||||
CliResult result = run(new CapturingClient(new Eip4HttpResponse(200, "{}")),
|
||||
"init",
|
||||
"--dir", target.toString(),
|
||||
"--skills-dir", skillsDir.toString(),
|
||||
"--base-url", "http://localhost:8093");
|
||||
|
||||
assertEquals(0, result.code());
|
||||
Path skill = target.resolve(".claude/skills/eip4-demo/SKILL.md");
|
||||
assertTrue(Files.exists(skill));
|
||||
String content = Files.readString(skill, StandardCharsets.UTF_8);
|
||||
assertTrue(content.startsWith("---"), "should carry YAML frontmatter");
|
||||
assertTrue(content.contains("name: eip4-demo"));
|
||||
assertTrue(content.contains("description: 演示用 skill"));
|
||||
assertTrue(content.contains("http://localhost:8093/api/ai/features/auto-develop"));
|
||||
assertFalse(content.contains("{{EIP4_BASE_URL}}"), "placeholder must be rendered");
|
||||
}
|
||||
|
||||
@Test
|
||||
void initGeneratesAgentsMdWithSkillCatalog() throws Exception {
|
||||
Path skillsDir = writeSkillsFixture();
|
||||
Path target = tempDir.resolve("proj");
|
||||
|
||||
CliResult result = run(new CapturingClient(new Eip4HttpResponse(200, "{}")),
|
||||
"init",
|
||||
"--dir", target.toString(),
|
||||
"--skills-dir", skillsDir.toString(),
|
||||
"--base-url", "http://localhost:8093");
|
||||
|
||||
assertEquals(0, result.code());
|
||||
Path agents = target.resolve("AGENTS.md");
|
||||
assertTrue(Files.exists(agents));
|
||||
String md = Files.readString(agents, StandardCharsets.UTF_8);
|
||||
assertTrue(md.contains("EIP4-SKILLS:BEGIN"), "should carry a managed marker block");
|
||||
assertTrue(md.contains("EIP4-SKILLS:END"));
|
||||
assertTrue(md.contains("eip4-demo"));
|
||||
assertTrue(md.contains("演示用 skill"));
|
||||
assertTrue(md.contains("http://localhost:8093"));
|
||||
}
|
||||
|
||||
@Test
|
||||
void initUsesCurrentEnvBaseUrlWhenNoFlag() throws Exception {
|
||||
Path skillsDir = writeSkillsFixture();
|
||||
Path target = tempDir.resolve("proj");
|
||||
Eip4EnvStore store = tempStore();
|
||||
run(store, new CapturingClient(new Eip4HttpResponse(200, "{}")),
|
||||
"env", "add", "--name", "dev", "--base-url", "http://localhost:8093", "--use");
|
||||
|
||||
CliResult result = run(store, new CapturingClient(new Eip4HttpResponse(200, "{}")),
|
||||
"init",
|
||||
"--dir", target.toString(),
|
||||
"--skills-dir", skillsDir.toString());
|
||||
|
||||
assertEquals(0, result.code());
|
||||
String content = Files.readString(
|
||||
target.resolve(".claude/skills/eip4-demo/SKILL.md"), StandardCharsets.UTF_8);
|
||||
assertTrue(content.contains("http://localhost:8093"), "should fall back to current env base URL");
|
||||
}
|
||||
|
||||
@Test
|
||||
void initPreservesUserContentOutsideMarkerBlock() throws Exception {
|
||||
Path skillsDir = writeSkillsFixture();
|
||||
Path target = tempDir.resolve("proj");
|
||||
Files.createDirectories(target);
|
||||
Files.writeString(target.resolve("AGENTS.md"),
|
||||
"# My project\n\n用户自定义说明,必须保留。\n", StandardCharsets.UTF_8);
|
||||
|
||||
CliResult result = run(new CapturingClient(new Eip4HttpResponse(200, "{}")),
|
||||
"init",
|
||||
"--dir", target.toString(),
|
||||
"--skills-dir", skillsDir.toString(),
|
||||
"--base-url", "http://localhost:8093");
|
||||
|
||||
assertEquals(0, result.code());
|
||||
String md = Files.readString(target.resolve("AGENTS.md"), StandardCharsets.UTF_8);
|
||||
assertTrue(md.contains("# My project"), "user heading must survive");
|
||||
assertTrue(md.contains("用户自定义说明,必须保留。"), "user content must survive");
|
||||
assertTrue(md.contains("EIP4-SKILLS:BEGIN"), "managed block must be injected");
|
||||
assertEquals(1, md.split("EIP4-SKILLS:BEGIN", -1).length - 1, "exactly one managed block");
|
||||
}
|
||||
|
||||
@Test
|
||||
void initEmbedsFullSkillBodyIntoAgentsMd() throws Exception {
|
||||
Path skillsDir = writeSkillsFixture();
|
||||
Path target = tempDir.resolve("proj");
|
||||
|
||||
CliResult result = run(new CapturingClient(new Eip4HttpResponse(200, "{}")),
|
||||
"init",
|
||||
"--dir", target.toString(),
|
||||
"--skills-dir", skillsDir.toString(),
|
||||
"--base-url", "http://localhost:8093");
|
||||
|
||||
assertEquals(0, result.code());
|
||||
String md = Files.readString(target.resolve("AGENTS.md"), StandardCharsets.UTF_8);
|
||||
// Codex / OpenCode read AGENTS.md, not .claude/skills — the full body must be inline.
|
||||
assertTrue(md.contains("eip4 ai auto-develop"), "AGENTS.md should embed the full skill body");
|
||||
assertTrue(md.contains("http://localhost:8093/api/ai/features/auto-develop"),
|
||||
"embedded body must also be rendered");
|
||||
}
|
||||
|
||||
private Path writeSkillsFixture() throws Exception {
|
||||
Path dir = tempDir.resolve("skills-src");
|
||||
Files.createDirectories(dir);
|
||||
Files.writeString(dir.resolve("manifest.json"), """
|
||||
{
|
||||
"skills": [
|
||||
{"file": "eip4-demo.md", "name": "eip4-demo", "description": "演示用 skill"}
|
||||
]
|
||||
}
|
||||
""", StandardCharsets.UTF_8);
|
||||
Files.writeString(dir.resolve("eip4-demo.md"), """
|
||||
# Skill: eip4-demo
|
||||
|
||||
调用示例:
|
||||
|
||||
```bash
|
||||
eip4 ai auto-develop --base-url {{EIP4_BASE_URL}}
|
||||
curl {{EIP4_BASE_URL}}/api/ai/features/auto-develop
|
||||
```
|
||||
""", StandardCharsets.UTF_8);
|
||||
return dir;
|
||||
}
|
||||
|
||||
private Path validPackageFile(String name) throws Exception {
|
||||
return packageFile(name, "aipkg-1",
|
||||
"insert into sys_page_schema values ('x')",
|
||||
|
||||
Reference in New Issue
Block a user