关于 nocobase-utils
nocobase-utils 是提供 NocoBase 跨功能实用工具权威参考资料的 Agent 技能,面向编写筛选条件、评估表达式及生成 UID 等任务。内容按主题组织,并强调依据字段类型选择筛选运算符。
主要功能
- 01按主题提供实用工具参考
- 02说明筛选条件格式与运算符
- 03涵盖表达式引擎与函数
- 04提供 UID 生成脚本
适用场景
- 01为 NocoBase 字段构造筛选条件
- 02查阅表达式引擎及可用函数
- 03为 UI Schema 生成短 UID
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ nocobase/ skills --skill nocobase-utils安装后在 Claude Code 中输入/nocobase-utils确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/evaluators/formulajs.mdindex.mdmathjs.mdreferences/filter/index.mdreferences/uid/index.mdscripts/uid.js详细介绍
目标
提供准确、权威的 NocoBase 跨领域工具参考信息。内容按主题组织,并会逐步扩展。
适用场景
当你需要适用于多个 NocoBase 功能的权威参考资料时,请调用此技能(或其子参考资料),例如:
- 构造任何持久化或可在 UI 中显示的 NocoBase 筛选条件,尤其是在根据自然语言意图选择运算符时
- 表达式求值引擎及其可用函数
- 为 UI 架构或其他配置负载生成简短的不透明 UID
- 其他共享工具(后续添加)
编写筛选条件时,请使用主题 filter 调用此技能;阅读筛选参考资料是必需的前置步骤,不可省略。输出运算符之前,请确定终端字段的当前接口/类型,并从该字段组的允许列表中选择运算符。不要依据模型知识,直接将“之前”“小于”“至少”或“不晚于”等词语转换为通用比较运算符。
附带脚本
- 当 UI 或架构负载需要简短的随机 UID,且项目中没有现成的辅助工具时,请复用 scripts/uid.js。
- 此脚本支持两种用法:在目标代码中导入
uid(),或在当前工作区中解析脚本路径,然后运行node <resolved-path-to-uid.js> 16,以便在 Agent 工作期间输出 UID。
参考索引
| 主题 | 文件 |
|---|---|
| 筛选条件格式——结构、运算符、变量 | references/filter/index.md |
| 求值引擎——概览、引擎选择、关键规则 | references/evaluators/index.md |
| formula.js 完整函数参考 | references/evaluators/formulajs.md |
| math.js 完整函数参考 | references/evaluators/mathjs.md |
| UID 生成——适用场景、注意事项、用法示例 | references/uid/index.md |
评论
支持 Markdown