feat(cli): eip4 skills list/check + 3 个新 agent skill (G3)

- 新增 skill(均基于源码核实过的端点):
  - eip4-data-modeling — /api/meta/entity 建实体/加字段/引用列/主子表
  - eip4-page-recipe   — /api/design/recipe/compile 生成默认页(维护/树/主子表)
  - eip4-acl-manage    — /api/admin/* 菜单/角色/用户组授权
  manifest.json + jar 打包同步,docs/skills 现共 6 个
- CLI 新增 eip4 skills list(列内置 skills)+ skills check --dir(缺失退出非 0)
- TDD 2 个新测试,platform-cli 共 22 单测全绿
- 真实验证:skills list 列 6 个 / init 装 6 个 / skills check 全 installed(exit 0)/ 端口渲染零占位符残留
- serviceflow-diagnose 暂缓:平台无「查看/诊断服务流定义」的 agent 可操作端点(需先补端点)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-06-22 14:47:31 +08:00
parent 4a2080a4f6
commit 8a6c94ebde
8 changed files with 256 additions and 1 deletions

View File

@@ -62,6 +62,7 @@ public final class Eip4Cli {
}
return switch (args[0]) {
case "init" -> runInit(args, out, err);
case "skills" -> runSkills(args, out, err);
case "env" -> runEnv(args, out, err);
case "ai" -> runAi(args, out, err);
case "release" -> runRelease(args, out, err);
@@ -770,6 +771,74 @@ public final class Eip4Cli {
return agents;
}
private int runSkills(String[] args, PrintStream out, PrintStream err) throws IOException {
if (args.length < 2 || isHelp(args[1])) {
printSkillsHelp(out);
return 0;
}
return switch (args[1]) {
case "list" -> runSkillsList(args, out, err);
case "check" -> runSkillsCheck(args, out, err);
default -> fail(err, "Unknown skills command: " + args[1]);
};
}
private int runSkillsList(String[] args, PrintStream out, PrintStream err) throws IOException {
Options options = Options.parse(args, 2);
JsonNode manifest = readSkillsManifest(options, err);
if (manifest == null) {
return 1;
}
for (JsonNode skill : manifest.path("skills")) {
out.println(skill.path("name").asText() + " — " + skill.path("description").asText());
}
return 0;
}
private int runSkillsCheck(String[] args, PrintStream out, PrintStream err) throws IOException {
Options options = Options.parse(args, 2);
Path targetDir = Path.of(options.single("dir") == null ? "." : options.single("dir"));
JsonNode manifest = readSkillsManifest(options, err);
if (manifest == null) {
return 1;
}
int missing = 0;
for (JsonNode skill : manifest.path("skills")) {
String name = skill.path("name").asText();
Path skillFile = targetDir.resolve(".claude").resolve("skills").resolve(name).resolve("SKILL.md");
boolean installed = Files.exists(skillFile);
out.println((installed ? "[installed] " : "[missing] ") + name);
if (!installed) {
missing++;
}
}
if (missing > 0) {
err.println(missing + " 个 skill 未安装;运行 `eip4 init` 安装。");
return 1;
}
return 0;
}
private JsonNode readSkillsManifest(Options options, PrintStream err) throws IOException {
String manifestJson = skillSource(options.single("skills-dir")).read("manifest.json");
if (manifestJson == null) {
fail(err, "找不到 skills manifest.json(--skills-dir 指向的目录或内置资源缺失)");
return null;
}
return objectMapper.readTree(manifestJson);
}
private void printSkillsHelp(PrintStream out) {
out.println("""
Usage:
eip4 skills list [--skills-dir DIR]
eip4 skills check --dir DIR [--skills-dir DIR]
list 列出内置(或 --skills-dir 指定)的 agent skills。
check 检查目标项目 .claude/skills 下已安装/缺失的 skill;有缺失时退出码非 0。
""");
}
private SkillSource skillSource(String skillsDir) {
if (skillsDir != null && !skillsDir.isBlank()) {
Path dir = Path.of(skillsDir);

View File

@@ -14,6 +14,21 @@
"file": "eip4-release-manage.md",
"name": "eip4-release-manage",
"description": "EIP4 部署包、人审、发布前校验与回滚边界"
},
{
"file": "eip4-data-modeling.md",
"name": "eip4-data-modeling",
"description": "建实体/加字段/引用列/主子表(/api/meta/entity)"
},
{
"file": "eip4-page-recipe.md",
"name": "eip4-page-recipe",
"description": "用 recipe 生成默认页:维护/树/主子表(/api/design/recipe/compile)"
},
{
"file": "eip4-acl-manage.md",
"name": "eip4-acl-manage",
"description": "菜单/角色/用户组授权(/api/admin/*)"
}
]
}