- 新增 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>
2.3 KiB
2.3 KiB
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):
# 可选:先登记环境地址(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 内读取,无需仓库在场。
通用原则
- 优先使用
platform-cli,其次使用公开 REST API,最后才考虑人工 SQL。 - 默认只允许本地开发和测试环境自动执行写操作。
- 线上环境只能生成部署包和校验证据,不能由 Agent 默认直接写入。
- 每次自动开发必须保留 request、draft、change-set、apply、smoke、repair、deployment package evidence。
- 任何失败先回到本地复现和修复,再重新生成部署包。