- 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>
65 lines
2.5 KiB
Markdown
65 lines
2.5 KiB
Markdown
# 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 探测环境:
|
||
|
||
```bash
|
||
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
|
||
```
|
||
|
||
5. 如果服务未启动,优先使用重新打包后的 jar:
|
||
|
||
```bash
|
||
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`):
|
||
|
||
```bash
|
||
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` 或等效人工确认。
|
||
|
||
## 常用命令
|
||
|
||
```bash
|
||
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
|
||
```
|