Platform Script Skills

---

name: platform-script description: "提供自研业务平台的脚本模板和编码规范。当用户需要编写 Groovy 后端脚本、JavaScript 表单脚本、SQL 查询、附件处理等代码时使用此技能。" metadata: { "openclaw": { "emoji": "📝", "requires": { "bins": [] } } }

---

平台脚本技能

为自研业务平台提供全面的脚本模板和编码规范。

何时使用

✅ 使用此技能的情况：

"帮我写一个平台脚本"

"需要数据增删改查的脚本"

"表单验证脚本怎么写"

"动态控制下拉框选项"

"合并多个 CI 附件为 PDF"

"发送邮件的脚本"

"SQL 查询/分页脚本"

"审批流程相关脚本"

"根据我的平台规则写代码"

何时不使用

❌ 不使用此技能的情况：

通用编程问题（不使用平台特定 API）

其他平台的脚本代码

与平台无关的代码需求

技能位置

skills/platform-script-skills/

使用方法

当用户请求平台相关的脚本代码时，读取 references/ 目录中的完整模板文件，理解平台的特殊脚本规则，生成符合规范的可用代码。

核心能力

1. 基础脚本操作

数据创建 (DataModelUtils.createCIByCIClassName)

数据删除 (DataModelUtils.deleteCi, deleteCis)

数据修改 (saveCi)

数据查询 (getCIByPK, getCIByAttr, queryForListMap)

脚本调用 (ScriptUtils.runScriptByCode)

2. 表单脚本操作

数据验证 (validatorFunctions)

动态字段控制 (disabledAttributes, dynamicDisabledAttrs)

字段值变化 (changeFunctions)

下拉框选项控制 (scriptFilterInOptions, setSelectOptionsFunc)

字段显示控制 (controlFieldDisplayFunc)

自动补全 (controlAutoCompleteFunc)

父子表单通信 (addObserver, notifyParent)

智能回填 (initBackFillData, initNestedFormData)

3. SQL 脚本操作

数据查询 SQL

数据修改 SQL (JDBCUtils.update)

分页处理 (LIMIT/OFFSET、逻辑分页)

多表连接查询

4. 附件处理

附件函数 (AttachmentsUtils.*)

文件导出 (Excel、Word、PDF、zip)

多 CI 附件转 PDF

PDF 合并

Word 合并

5. 审批流程

自定义提交流程 (flow_base_start)

自定义通过流程 (flow_pass)

自定义加签脚本 (flow_add_object_by_standalone)

6. 工具函数

日期格式化 (SimpleDateFormat)

时间戳生成

列表排序 (sortMapList)

字符串处理 (removeTrailingZeros)

7. 业务特定脚本

华龙业务相关

FOS 数据查询

航班数据操作

特殊规范

变量命名

使用中文变量名（如 def 主表数据, def 明细表数据）

遵循平台的字段命名规范

数据模型操作

// 单条记录
def 数据 = DataModelUtils.getCIByPK("表名",['ID':值])
// 多条记录
def 数据列表 = DataModelUtils.getCIByAttr("表名",['字段名':值])
// 保存
saveCi(数据)
// 删除
DataModelUtils.deleteCi(数据)
DataModelUtils.deleteCis(数据列表)

表单脚本返回格式

if(args$){
    return {
        "validatorFunctions": fieldValidateMap,
        "disabledAttributes": list,
        "changeFunctions": feildMapFunc,
        "setSelectOptionsFunc": optionsFunc
    };
}else{
    return null;
}

脚本参数说明

args$ - 脚本参数变量

args$.data - 表单输入数据

args$.getFieldValueFunc - 获取字段值函数

args$.setFieldValueFunc - 设置字段值函数

args$.runScriptFunc - 调用后台脚本

args$.notification - 打印信息 (error/warning/info/success)

重要提示

1. 访问 args$ 属性前先检查其是否存在 2. 监听脚本使用 ci$.dataFieldMap 访问当前数据 3. 附件字段需要使用 JsonSlurper 将大文本转换为 JSON 4. 导出文档时使用正确的模板占位符语法 5. 妥善处理 null 值避免异常

完整模板位置

所有完整代码示例存储在 references/platform-script-templates.txt 文件中，包含：

完整的代码示例

详细的注释说明

各种场景的最佳实践

当需要编写具体脚本时，会参考此文件中的完整模板生成代码。