- 新增 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>
10 KiB
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 不知道端口,第一步就劝退。
做什么:
- 新增
eip4 init(或独立脚本scripts/install-skills.sh),把docs/skills/*.md安装到各 agent 能自动读取的位置:- Claude Code:
.claude/skills/(或写入项目CLAUDE.md引用块) - Codex:项目根
AGENTS.md - OpenCode:其 agent 规则/上下文目录
- Claude Code:
- 安装时把 skills 里的
--base-url占位符用当前 env registry 的 current env 渲染(解决8084vs8093/8094不一致)。 - 安装完打印「下一步:
cd <dir> && claude」引导,对齐 NocoBase 体验。
验收:
- 一条命令后,新开 Claude Code 会话能识别
eip4-ai-feature-developmentskill,并据此跑通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-developeip4.list_page_recipes→GET /api/ai/page-recipeseip4.validate_page_schema→POST /api/page/schema/validateeip4.list_components→GET /api/page/schema/componentseip4.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 仍要猜。
做什么:
- 补 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(默认流生成与排错)
- 给 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 全自动开发 / 人力大幅下降」(决策会纪要商务条款③)。
五、建议执行顺序
- G1 一键接入(P0,半天级):投入最小、最快让 claude code/codex 真正能用上 EIP4。
- G2 MCP server 最小骨架(P1):把接入面标准化,去掉「agent 死记用法」。
- G3 Skills 补全(P1,可与 G2 并行):提升 agent 自主完成度。
- ②面(内置 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 为准,落地后回写该总览。