- fix: page-recipe 的 maintenance-crud 漏 `-v1`,而 compile 端点精确匹配 maintenance-crud-v1,agent 照抄示例会 400;统一为 -v1,并引导以 GET /api/ai/page-recipes 为权威列表,避免硬写字面量漂移。 - env-manage 新增「鉴权/Token」段:非 prod profile permitAll 免 token, prod/JWT 环境需 POST /api/auth/login 取顶层 `token` + `Authorization: Bearer` (核实 AuthController/JwtAuthFilter)。 - AGENTS.md(writeAgentsMd):把「优先 platform-cli」误导修为按类分流 (env/ai/release 用 CLI,建模/页面/授权用 REST 或 platform-mcp), 并点名 platform-mcp 注册方式 + token 获取指引。 - data-modeling/page-recipe/acl-manage 各加调用方式与 token 交叉引用。 - 测试 +3:page-recipe recipe-id 回归、AGENTS.md MCP/auth、bundled skills 防漂移。 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2.5 KiB
2.5 KiB
Skill: eip4-env-manage
触发场景
- 用户要求启动、检查或切换 EIP4 环境。
- 用户要求 Agent 在本地验证功能。
- 用户要求确认当前服务是否可被 AI 自动开发链路使用。
操作规则
- 确认当前目录是否是独立 worktree,避免污染用户正在做的任务。
- 使用 JDK 21,不能使用 JDK 26。
- 默认本地 base URL 由
eip4 init渲染,当前环境为{{EIP4_BASE_URL}};多套环境用eip4 env add/use管理。 - 使用 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
- 如果服务未启动,优先使用重新打包后的 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
鉴权 / Token
- 非 prod profile(default / local / ci)放行
/api/**;本地eip4 init默认渲染 local,故本地 curl / CLI 无需 token。 - prod 或开启 JWT 的环境:
/api/**需请求头Authorization: Bearer <token>(/api/auth/**例外,登录本身免令牌)。 - 取 token(登录响应顶层字段
token=JWT、expireSeconds=过期秒数;失败 401 仅含success:false+msg):
TOKEN=$(curl -s -X POST {{EIP4_BASE_URL}}/api/auth/login \
-H "Content-Type: application/json" \
-d '{"account":"admin","password":"111111"}' \
| python3 -c 'import sys,json;print(json.load(sys.stdin)["token"])')
curl {{EIP4_BASE_URL}}/api/meta/entities -H "Authorization: Bearer $TOKEN"
admin/111111为本地 dev 种子账号;按环境替换。
禁止事项
- 不在用户原始任务目录中直接改动或启动长时间任务,除非用户明确要求。
- 不把线上环境设置为默认写入目标。
- 不跳过 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