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

jeecg-desform

JeecgBoot 表单设计器(desform)全生命周期管理——通过对话的方式创建、更新、复制、删除表单设计器,管理表单数据(CRUD),生成 PC/移动端表单视图,以及一键创建 OA 审批应用(表单+流程+授权)。只要用户意图涉及「表单设计器」就必须使用本技能,包括但不限于:创建或生成表单("做一个请假表单"、"AI设计表单"、"desform")、修改已有表单或字段("加个字段"、"改一下表单")、复制/删除表单、录入或查询表单数据、创建表单视图(含移动端)、以及咨询设计器功能(控件类型、字典配置、校验规则、关联记录、子表、公式计算、JS/CSS增强、默认值、外链等)。当用户想要创建带审批流程的 OA 应用时也应触发("创建OA应用"、"创建审批单"、"创建报销单"、"创建请假单"、"做一个OA表单带流程"、"一键创建表单和流程"、"面试申请"、"出差申请"等)。即使用户只是描述字段需求(如"需要姓名、手机号字段")而未明确说"表单",只要语境指向表单设计器也应触发。注意:本技能仅处理表单设计器(desform),不处理 Online 表单——如果用户明确提到"Online表单"或"online表",应使用 jeecg-onlform 技能。

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-desform

About this skill


name: jeecg-desform description: JeecgBoot 表单设计器(desform)全生命周期管理——通过对话的方式创建、更新、复制、删除表单设计器,管理表单数据(CRUD),生成 PC/移动端表单视图,以及一键创建 OA 审批应用(表单+流程+授权)。只要用户意图涉及「表单设计器」就必须使用本技能,包括但不限于:创建或生成表单("做一个请假表单"、"AI设计表单"、"desform")、修改已有表单或字段("加个字段"、"改一下表单")、复制/删除表单、录入或查询表单数据、创建表单视图(含移动端)、以及咨询设计器功能(控件类型、字典配置、校验规则、关联记录、子表、公式计算、JS/CSS增强、默认值、外链等)。当用户想要创建带审批流程的 OA 应用时也应触发("创建OA应用"、"创建审批单"、"创建报销单"、"创建请假单"、"做一个OA表单带流程"、"一键创建表单和流程"、"面试申请"、"出差申请"等)。即使用户只是描述字段需求(如"需要姓名、手机号字段")而未明确说"表单",只要语境指向表单设计器也应触发。注意:本技能仅处理表单设计器(desform),不处理 Online 表单——如果用户明确提到"Online表单"或"online表",应使用 jeecg-onlform 技能。

JeecgBoot 表单设计器 AI 自动生成器

使用自然语言(或图片)生成表单设计器配置。

重要:本 skill 只处理「表单设计器」(desform),不涉及 Online 表单。两者是完全独立的表单体系。


执行准则(必读)

本技能的所有强制规则,都在对抗同一个 AI 倾向:用"我大概知道"替代"我确认知道"。

跳步:校验、确认、读文档看似多余——AI 倾向于省略。但每个步骤都是防错设计,省略后出错时代价是数据损坏或 API 异常,且无法回头。

猜测:系统特定的编码、API 参数格式、控件配置细节,训练知识不够用,但 AI 会用"看起来合理"的值填补——配置看似正确,运行时才报错。

本系统有大量与通用认知冲突的特殊行为(API 接口不可靠、参数大小写有严格要求、控件结构非直觉、部分值只存在于用户自己的系统中)。你对这个系统的了解程度,不如这份文档和用户本身。

遇到任何操作,遵守以下三条:

  1. 步骤不可跳 — 感觉没必要时仍要执行,这是防错机制而不是形式
  2. 有专属文档的功能先读文档 — 通用知识在本系统大概率是错的,文档记录的是实测验证的行为
  3. 系统特定的值必须问 — 无法从当前上下文确认的参数(规则 Code、报表编码、业务 ID 等),直接告知用户"需要您提供 X",不要猜测

第 2 条的执行方式(强制): 遇到不确定某功能在哪里配置时,先在 SKILL.md 末尾的参考文档列表中找到对应的 references/ 文件并读取,再执行任何 API 操作。参考文档列表覆盖了所有专属功能,是权威索引。


临时配置文件规则(强制)

所有传给脚本的 --config <xxx.json> 必须放在 {系统临时目录}/jeecg-desform/ 下,由操作系统自动清理;skill 与脚本均不主动删除该目录或文件。

tempfile.gettempdir() 自动适配各平台:Windows %TEMP%、Linux /tmp、macOS /var/folders/.../T(注意 macOS 并非 /tmp)。文件名建议使用 <表名>_<步骤>.json(如 sk_audit_create.json),路径已含技能名称无需重复前缀。

场景一:Claude 用 Write 工具写文件后调脚本(最常见)

Write 工具需要绝对路径,所以必须先通过公共脚本拿到路径。脚本一次完成「定位系统临时目录 → 创建技能子目录 → 返回路径」:

# 取目录
python "<skill目录>/scripts/skill_temp_path.py"
# → C:\Users\xxx\AppData\Local\Temp\jeecg-desform

# 直接拿完整文件路径(推荐)
python "<skill目录>/scripts/skill_temp_path.py" -f sk_audit_create.json
# → C:\Users\xxx\AppData\Local\Temp\jeecg-desform\sk_audit_create.json

得到路径后:

  1. 用 Write 工具将 JSON 写入该路径
  2. 调脚本 --config <该路径>

会话内目录可复用——首次取到后缓存到上下文,后续临时文件直接拼接同一前缀,不必每次重新调用脚本。

场景二:技能内的 Python 脚本自行写中间文件

skill 自己的脚本(desform_creator.py 等)在脚本进程内写文件时,不要通过 Write 工具,直接用 tempfile:

import tempfile, os, json

skill_dir = os.path.join(tempfile.gettempdir(), "jeecg-desform")
os.makedirs(skill_dir, exist_ok=True)          # 确保目录存在,不主动检查

config_path = os.path.join(skill_dir, 'sk_audit_create.json')
with open(config_path, 'w', encoding='utf-8') as f:
    json.dump(cfg, f, ensure_ascii=False, indent=2)

❌ 禁止

  • 写到 <skill>/tmp/ 或当前工作目录(污染 skill / 用户项目)
  • 硬编码 /tmp、C:\Temp 或任何固定路径(不跨平台)
  • 每步完成后主动 rm / Remove-Item(操作系统会清理,属多余 tool call)
  • 主动 os.path.exists() 检查(其本身即为一次 tool call) (os.makedirs(…, exist_ok=True) 与 skill_temp_path.py 都已隐式建目录,无需另外检查)

文件丢失补救

临时文件可能被操作系统异步清理,但仍遵循 乐观调用 + 报错补救:仅当脚本返回 FileNotFoundError 或 配置文件不存在 时,使用相同内容、在相同的 {系统临时目录}/jeecg-desform/ 路径下重写(重写前重新调一次 skill_temp_path.py 或 os.makedirs(skill_dir, exist_ok=True) 确保目录存在),切勿更换路径或回退至 skill 目录。


lowApp 模式(敲敲云 / 零代码模式)

当用户提及以下任一场景时,必须先阅读 references/desform-lowapp.md,再执行任何操作:

  • 用户说「工作表」(而非「表单」)
  • 用户说「在 xxx 应用下」「应用里」「某个应用中」
  • 用户说「敲敲云」「零代码」「lowApp」
  • 用户提到「组织」「租户」(作为操作对象,而非系统权限配置)

lowApp 模式下:

  • 表单设计器表单 = 工作表(概念同,名称不同)
  • 需要「组织(租户)+ 应用」两级上下文
  • 初始化用 init_lowapp,不是 init_api
  • 初始化后,create_form、add_widget 等所有表单操作函数无需修改,自动生效
  • 详细说明见 references/desform-lowapp.md(概念+流程)和 references/desform-lowapp-utils.md(函数导入方式与完整说明)

前置条件

用户必须提供以下信息(或由 AI 引导确认):

  1. API 地址:JeecgBoot 后端地址(如 https://boot3.jeecg.com/jeecgboot)
  2. X-Access-Token:JWT 登录令牌(从浏览器 F12 获取)

如果用户未提供,提示:

请提供 JeecgBoot 后端地址和 X-Access-Token(从浏览器 F12 → Network → 任意请求的 Request Headers 中复制)。

API 初始化(统一入口)

所有 Python 操作前都需要先初始化 API 连接。init_api 只存在于 desform_utils.py 中,其他模块(如 desform_data_utils.py)不包含此函数——错误导入会导致 ImportError。

import sys
sys.path.insert(0, r'<skill目录>/scripts')
from desform_utils import init_api
init_api('<api_base>', '<token>')

后续按需从各模块导入函数,查阅函数详细说明时: 先 grep 函数名定位行号,再用 offset+limit 读取对应章节,不要全量阅读文档。

# 示例:查 update_design_config 的用法
grep -n "## update_design_config" references/desform-python-utils.md
# 得到行号后:Read 该文件,offset=<行号-1>, limit=40

desform_utils 函数速查表

完整函数列表见 references/desform-python-utils.md;列表视图函数见 references/desform-list-view.md。

函数适用场景
表单生命周期
check_code_available(code)新建前校验编码唯一性
create_form(name, code, widgets, ...)一站式创建表单(查找/创建→保存设计→同步权限)
update_form(code, widgets, ...)整体重设计已有表单
update_design_config(code, config_updates)只改配置不改控件(发布/通知/打印/业务规则等)
query_form(code)查询表单完整信息(含设计JSON)
get_form_fields(form_code)获取所有字段的 model/key/type 映射
字段级操作
add_widget(code, widget_or_widgets)追加字段到已有表单末尾
update_widget(code, changes, *, key=None, model=None)修改字段属性(优先传 key=)
delete_widget(code, *, key=None, model=None)删除字段(优先传 key=)
设计JSON预处理
export_design_json(code, output_path)导出设计JSON到文件(用于手动修改场景)
save_design_from_file(code, file_path)将修改后的文件保存回后台
extract_field_table_from_design(design_json)从设计JSON提取字段参照表(不调用API)
工具
query_dict(dict_code)查询字典项列表
search_dict(keyword)按名称/编码模糊搜索字典
gen_menu_sql(parent_name, children, ...)生成菜单和角色授权SQL

主数据复用规则

表单字段配置字典、选人、选部门等数据源时,遵循"先查后建"原则——先查系统是否已有该字典/角色/部门,避免重复创建。

使用 jeecg-system skill 的 system_utils.py 查询和管理主数据,详见 jeecg-system 技能。


创建表单

1. 解析用户需求

从用户描述中提取:表单名称、表单编码(英文命名,模块名前缀)、字段列表、字段属性。

布局选择规则: 默认使用普通布局(auto/half/full),不要主动使用 Word 风格。只有当用户明确要求时才使用 layout: "word"——例如用户说"Word风格"、"表格边框样式"、"像Word文档那样"等。即使表单是审批单、申请表等看起来适合 Word 风格的场景,也不要自行判断使用 Word 风格,而是让用户来决定。

编码唯一性校验(新建表单时):

创建新表单时,生成 desformCode 后立即执行编码校验,在校验通过前不要展示摘要让用户确认。原因:用户确认摘要后会期望直接执行成功,如果执行时才发现编码冲突,体验很差,且可能意外覆盖已有表单数据。

from desform_utils import init_api, check_code_avail
Read the complete source ↗