java-codegen-from-db

java-codegen-from-db

工作流总览

本 skill 把"从数据库表生成 Java 代码"拆为 5 个显式阶段,每个阶段调用具体的 MCP 工具,关键决策点会暂停让用户确认。不允许跳步——前一步的输出是后一步的输入。

[1] 预检查项目  →  [2] schema 分析  →  [3] 语义增强(可选)
                                              ↓
                  [5] 写盘   ←   [4] 分层渲染(等待用户确认)

---

阶段 1: 预检查项目(必做)

目的: 在生成代码前确认目标 Spring Boot 项目结构合法、依赖大致齐全。否则生成出来也编译不过。

1.1 验证项目结构

调用 springboot_validate_project:

• 参数: { "check_dependencies": true, "create_missing_dirs": true, "template_category": "<用户选定的分类>" }
• 期待返回中包含 Project Structure: ✅ OK 或 ✅ Project Root
• 如果失败 → 告诉用户具体缺什么,不要继续

1.2 分析依赖健康度

调用 springboot_analyze_dependencies:

• 参数:

  {
    "template_category": "<同上>",
    "database_type": "mysql|postgresql|sqlite",
    "include_swagger": true,
    "include_lombok": true,
    "include_mapstruct": true
  }
  

• 返回中提取 Missing Dependencies: N:
  • N == 0 → health = 100,继续
  • N ≤ 2 → health = 80,继续但提醒用户
  • N ≤ 5 → health = 60,暂停让用户决定是否继续
  • N > 5 → health = 40,强烈建议先修依赖,问用户是否要看具体清单

1.3 渲染依赖健康仪表盘(MCP App)

如果客户端支持 MCP Apps(_meta 渲染),返回值中应附加:

{
  "_meta": {
    "mcp-apps/component": "dashboard",
    "mcp-apps/data": { "score": <health>, ... }
  }
}

现阶段如未支持,用文本表格代替。

---

阶段 2: schema 分析(必做)

目的: 拿到目标表的列、主键、外键、索引,这是模板渲染的输入。

2.1 建立或复用连接

如果用户尚未连接:

• 调用 db_connect_test with {host, port, username, password, database, database_type}
• 拿到 connection_id,记住它,后续所有调用都要带

2.2 列出表名(可选)

当用户没指明表,先列出来让用户选:

• 调用 db_query_tables with {connection_id, database}
• 把表名列给用户,等用户选

2.3 描述目标表

对每张目标表:

• 调用 db_table_describe with {connection_id, database, table, include_java_types: true}
• 这一步会返回列定义 + 推断的 Java 类型

2.4 获取外键关系

• 调用 db_table_foreign_keys with {connection_id, database, table}
• 多张表时一起调,然后给用户渲染 ER 图(MCP App mermaid 组件)

2.5 渲染 ER 图(MCP App)

当用户选了 ≥ 2 张表,构造 Mermaid erDiagram 字符串,放进 _meta["mcp-apps/source"]。

---

阶段 3: 语义增强(推荐,Phase 4 工具可用后启用)