Files
eip4-platform/docs/skills/eip4-env-manage.md
zhengwr 0e457d9945 feat(cli): agent 接入补全(token/MCP/REST 分流)+ 修 page-recipe recipe-id
- 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>
2026-06-23 09:50:23 +08:00

65 lines
2.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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
```