Files
eip4-platform/docs/skills/README.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

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