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-desformAbout 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 接口不可靠、参数大小写有严格要求、控件结构非直觉、部分值只存在于用户自己的系统中)。你对这个系统的了解程度,不如这份文档和用户本身。
遇到任何操作,遵守以下三条:
- 步骤不可跳 — 感觉没必要时仍要执行,这是防错机制而不是形式
- 有专属文档的功能先读文档 — 通用知识在本系统大概率是错的,文档记录的是实测验证的行为
- 系统特定的值必须问 — 无法从当前上下文确认的参数(规则 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
得到路径后:
- 用
Write工具将 JSON 写入该路径 - 调脚本
--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 引导确认):
- API 地址:JeecgBoot 后端地址(如
https://boot3.jeecg.com/jeecgboot) - 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-systemskill 的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 ↗