Files
eip4-platform/docs/skills/eip4-env-manage.md
zhengwr 5b06aeceff 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>
2026-06-22 14:14:26 +08:00

1.7 KiB
Raw Blame History

Skill: eip4-env-manage

触发场景

  • 用户要求启动、检查或切换 EIP4 环境。
  • 用户要求 Agent 在本地验证功能。
  • 用户要求确认当前服务是否可被 AI 自动开发链路使用。

操作规则

  1. 确认当前目录是否是独立 worktree,避免污染用户正在做的任务。
  2. 使用 JDK 21,不能使用 JDK 26。
  3. 默认本地 base URL 由 eip4 init 渲染,当前环境为 {{EIP4_BASE_URL}};多套环境用 eip4 env add/use 管理。
  4. 使用 CLI 探测环境:
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar env add \
  --name local \
  --base-url {{EIP4_BASE_URL}} \
  --kind local \
  --use

java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar env status
  1. 如果服务未启动,优先使用重新打包后的 jar:
JAVA_HOME=/opt/homebrew/opt/openjdk@21 mvn -pl platform-app -am install -DskipTests
/opt/homebrew/opt/openjdk@21/bin/java -jar platform-app/target/platform-app-0.1.0-SNAPSHOT.jar --spring.profiles.active=local

禁止事项

  • 不在用户原始任务目录中直接改动或启动长时间任务,除非用户明确要求。
  • 不把线上环境设置为默认写入目标。
  • 不跳过 JDK 版本检查。
  • 显式选择非当前 env 执行 AI 或发布类命令时,必须要求 --yes 或等效人工确认。

常用命令

java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar env list
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar env current
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar env use --name local
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar env status --all