Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Development

jeecg-codegen

Use when user asks to generate JeecgBoot CRUD code, create a new module, add/modify fields on existing module, or says "代码生成", "生成代码", "创建模块", "新增功能", "建表", "加字段", "加一个字段", "增加字段", "新增字段", "修改字段", "删除字段", "generate code", "new entity", "add field"

jeecgboot · AI review on file

Installation

Read the source and dependencies before running a command. Copying does not install or execute anything.

npx skills add jeecgboot/skills --skill jeecg-codegen

About this skill


name: jeecg-codegen description: Use when user asks to generate JeecgBoot CRUD code, create a new module, add/modify fields on existing module, or says "代码生成", "生成代码", "创建模块", "新增功能", "建表", "加字段", "加一个字段", "增加字段", "新增字段", "修改字段", "删除字段", "generate code", "new entity", "add field"

JeecgBoot 代码生成器

将自然语言需求转换为 JeecgBoot 全套 CRUD 代码(后端 Java + 前端 Vue3 + 菜单权限 SQL),并支持对已生成模块的增量字段修改。

主数据复用规则

重要: 生成代码涉及的字典、角色、用户、部门等主数据,必须遵循"先查后建"原则。 使用 jeecg-system skill 的 system_utils.py 查询和管理主数据。 详见 ../jeecg-system/SKILL.md。

⛔ 字典创建必须写入 Flyway SQL,禁止直接走 API 创建

代码生成场景下,新建字典的"建"必须落到 Flyway SQL 文件,禁止调用 find_or_create_dict() / create_dict() 等 API 在远程服务器上直接创建。

Why: 代码生成产物(Entity、前端、Flyway SQL)会通过 git 提交并部署到测试/预发/生产环境。如果字典只通过 API 在当前开发环境创建,部署到线上时线上数据库没有该字典,前端下拉框会空白、列表 _dictText 翻译失效。Flyway SQL 跟着代码走,所有环境拉到代码后执行迁移都会自动建上,是唯一能保证环境一致性的方式。

How to apply:

  • 查询字典 → 走 API 或 MySQL(jeecg-system skill 的 query-dicts / query-dict),用于"先查后建"中的"查"
  • 创建字典 → 写入当次的 Flyway SQL 文件(sys_dict INSERT + sys_dict_item 批量 INSERT),用于"先查后建"中的"建"
  • 禁用:find_or_create_dict()、create_dict() 等 system_utils 中的字典创建函数(在代码生成 skill 中不能调用)
  • 同理适用于:分类字典 sys_category 节点新建 — 也必须写入 Flyway SQL,禁止走 /sys/category/add API

例外: 角色、审批角色、用户绑定关系等"运行时主数据",由于跨业务可复用,可走 API 创建(按 jeecg-system 原流程)。字典与分类字典是"配置数据",必须走 SQL。

⛔ 接口禁止猜测规则

严格禁止猜测任何 API 接口路径或参数。 AI 不得根据命名惯例、框架约定或已知路径拼凑接口地址后直接调用。

所有接口调用必须来源于以下之一:

  1. 用户明确提供的接口文档或地址
  2. jeecg-system skill 中已记录的接口
  3. 通过 jeecg-system skill 查询后确认的接口

违反此规则即使偶然成功也视为错误操作,因为猜测成功不代表行为合规。

⛔ 写文件前的强制自检清单(高频翻车点)

以下两条是 AI 凭"框架直觉"最常犯错的地方,文件写出去几乎必现 bug,调试成本极高。每次执行 Step 4 写后端/前端文件之前,必须逐条 self-check。

翻车点 1:每个文件的路径必须与 SKILL/reference 描述完全一致

写每一个文件之前,必须先在 codegen-reference.md 顶部"文件清单"章节中找到对应文件的路径模板,逐字符比对后再写入。禁止凭"Spring Boot/JeecgBoot 框架直觉"猜测路径。

翻车点 2:FormSchema 必含隐藏 id 字段

所有 FormSchema(主表 Modal 表单、一对一子表 Form、ERP 风格子表 Form、树表 Modal 表单)首位必须包含:

{ label: '', field: 'id', component: 'Input', show: false },

为什么这是铁律: BasicForm 的 getFieldsValue() 只返回 schema 中声明过的字段。即使 Modal 打开时通过 setFieldsValue({ ...data.record }) 把 id 写入了表单状态,schema 没声明,提交时 getFieldsValue() 也会丢弃它。最终后端收到 entity.id == null,getById(null) 返回 null,Controller 返回 Result.error("未找到对应数据")。编辑功能直接报错。

位置统一规定:放在 FormSchema 数组首位(不要纠结"最后还是最前",统一首位)。

这两条规则不需要用户询问、不需要场景判断、不需要选项确认。100% 强制,100% 一致。

生成模式

进入交互流程之前,必须先与用户确认本次使用的生成模式。 任何场景下都不要默默选择,必须显式告知用户当前模式;用户回复"确认"即采用默认。

本 skill 提供两种生成模式:

模式状态默认说明
串行生成(Serial)Stable✅ 默认主 Agent 顺序生成后端 → 前端 → SQL,全程单线执行,稳定可靠
并行生成(Parallel)⚠️ Beta — 可能不稳定❌派发两个 SubAgent 并行生成前端 / 后端代码,主 Agent 负责契约冻结与跨端校验。详见同目录下 parallel-generation-mode.md

模式确认话术(必须执行)

进入 Step 0 之前,主 Agent 必须先输出类似以下消息,等用户回复后再继续:

本次代码生成将使用【串行生成模式】(默认,稳定)。
如需使用【并行生成模式(Beta)】以缩短耗时,请明确告知。
注意:并行模式当前为 Beta 版本,可能出现前后端字段命名漂移、API URL 不一致、
字典编码错位、FormSchema 隐藏 id 字段遗漏等问题,不确定时建议使用默认串行模式。

模式选择规则

  • 用户未明确要求并行 → 一律走 串行模式,不要主动建议并行。
  • 用户明确要求并行("并行"、"分头生成"、"前后端同时来"、"用 subagent 并行"等关键词) → 进入 并行模式,但必须先复述一遍 Beta 风险并等用户再次确认后才正式启动。
  • 增量字段修改场景(场景 C) → 强制串行,即使用户要求并行也要拒绝并解释(SubAgent 双重压缩会丢失已有代码细节)。
  • 一对多 + ERP / vue3Native / 自定义增强等复杂场景 → 强烈建议串行,需向用户说明风险后由用户决定。

并行模式启动条件(全部满足才进入)

  1. 用户明确选择了并行模式。
  2. 用户已被告知 Beta 风险并再次确认。
  3. 操作类型是"全量生成"(场景 A 或 B),不是"增量修改"(场景 C)。
  4. 主数据复用前置条件已就绪(字典已查/已建,目标数据库已确认)。

满足后,主 Agent 必须读取 parallel-generation-mode.md 并严格按其规范执行(契约冻结 → 派发 SubAgent → 跨端校验 → 输出清单)。任一环节失败 → 按该文档第 6 节"回退策略"切回串行从头来过。

铁律不变: 即使选择并行模式,本章上方的"⛔ 接口禁止猜测"、"⛔ 字典创建必须写入 Flyway SQL"、"⛔ 写文件前的强制自检清单(路径 + FormSchema id)"、以及"⛔ 铁律:Step 2 + Step 3 是不可跳过的硬性停止门" 全部仍然 100% 强制 —— 通过派发 prompt 传达给 SubAgent。

交互流程

⛔ 铁律:Step 2 + Step 3 是不可跳过的硬性停止门

全量生成必须严格按顺序执行 Step 0 → Step 1 → Step 2 → 等用户回复 → Step 3 → 等用户确认 → Step 4。 在用户明确回复"确认"(或等价表述)之前,绝对禁止开始生成任何代码、创建任何文件、执行任何 SQL。

以下念头出现时立刻停下,它们都是合理化跳过确认的借口:

借口现实
"需求描述足够清楚,可以直接推断"用户没有确认 ≠ 用户已认可。字段类型、路径、风格都可能偏差。
"选项都是默认值,不需要问"默认值是否适用由用户决定,不由 AI 决定。
"先生成再改很方便"用户不得不事后检查所有文件,浪费双方时间。
"用户说'Tab风格'已经隐含了风格选择"只说明了一个选项,其他9项仍需展示给用户确认。
"Skill 加载太慢,直接生成更高效"效率不是跳过确认的理由。

违反此铁律的代价: 用户发现问题后,所有已生成文件都需要重新生成或逐一修改。

Step 0 前置:判断前端目标(PC 端 / 移动端 / 两者都要)

此步骤必须在 Step 0 之前执行。前端目标直接决定 Step 2 中需要询问哪些选项。

识别移动端关键词: "移动端"、"手机端"、"UniApp"、"uniapp"、"APP端"、"小程序"、"H5"、"移动页面"、"APP页面"

根据用户描述判断:

用户意图判定结果Step 2 调整
明确只要移动端(含以上关键词,无 PC 相关词)仅移动端跳过 PC 前端选项(选项2、3、6、8、9),改为询问 UniApp3 项目根路径
明确只要 PC 端(含 "vue3"、"PC端"、"web端" 等词,无移动端词)仅 PC 端按原流程
两者都提到,或描述模糊(如"前后端代码"、"CRUD代码")不确定在 Step 2 前先询问用户:"请问需要生成哪端的前端代码?① 仅 PC 端(Vue3) ② 仅移动端(UniApp3) ③ 两者都要"

仅移动端时的 Step 2 选项调整:

  • 删除:前端风格(vue3/vue3Native)
  • 删除:PC 前端视图目录
  • 删除:PC 前端项目根路径
  • 删除:一对多布局风格(PC 端特有)
  • 删除:表单列数(PC 端特有)
  • 新增:UniApp3 项目根路径(必填)
  • 保留:后端模块、是否读取系统字典、后端项目根路径、数据库名称

两者都要时: 同时展示 PC 端和移动端的选项,分两组列出。

⚠️ 禁止默认跳过任何一端! 无法判断时必须询问用户,不得自行假设"用户可能只要 PC"或"用户只要移动端"。


Step 0: 判断操作类型 — 全量生成 or 增量修改?

识别增量修改的关键词: "加字段"、"增加字段"、"新增字段"、"加一个XX字段"、"删除字段"、"修改字段"、"改一下XX"、"给XX模块加"、"给XX表加"

如果是增量修改 → 进入 场景C 如果是全量生成 → 进入 场景A 或 场景B

Step 1: 全量生成 — 判断场景

场景A — 已有表(用户给了表名):

  1. 通过数据库查询获取精确 DDL(见"数据库连接"章节)
  2. 从 DDL 中解析:主键类型、全部字段(名称/类型/注释/是否nullable)、是否有系统字段
  3. 根据字段类型和注释自动推导前端控件类型
  4. 用户无需描述字段,AI 全部自动推导

场景B — 新建表(用户用自然语言描述需求):

  1. 从用户描述中提取:表名、实体名、功能描述、字段列表
  2. 用"智能字段推导"规则推导 DB 类型和前端控件
  3. 默认添加全部系统字段(create_by/create_time/update_by/update_time/sys_org_code)
  4. 生成建表 DDL 写入 Flyway SQL

场景C — 增量修改(给已有模块加/改/删字段):

  1. 定位目标模块:从用户提到的表名、模块名、实体名中识别目标
  2. 扫描已有代码文件:在后端和前端目录中搜索已生成的文件
    # <project_root>/<project_vue_root>:后端/前端项目根目录,使用前需向用户确认
    # 搜索后端 Entity 文件
    find <project_root> -name "{EntityName}.java" -path "*/entity/*"
    # 搜索前端 data.ts 文件
    find <project_vue_root
    
Read the complete source ↗