SuperAPI AI 工具集

create-bkn

通用与其它

查看项目

更新于 10-16 09:58

技能介绍

用途:create-bkn 用于编写 BKN(Business Knowledge Network,业务知识网络)定义文件,按 v2.0.1 规范生成结构完整的 .bkn 目录。BKN 采用 Markdown 加 YAML frontmatter 表达 schema,每种定义一个文件,放在对应类型子目录下;详细格式规则见 references/SPECIFICATION.llm.md。

主要能力:生成 {network_dir}/ 目录,包含 SKILL.md、network.bkn、可选的 CHECKSUM,以及 object_types/、relation_types/、action_types/、concept_groups/ 和可选 data/(CSV 实例数据)。提供 network_type、object_type、relation_type、action_type、concept_group 的模板与 k8s 网络示例,并附校验清单。

使用方式:先收集对象、关系、动作与可选概念组需求,阅读规范,从 assets/templates/ 复制适配模板;创建 network.bkn,再逐个创建 object_types/.bkn、relation_types/.bkn、action_types/.bkn 和可选 concept_groups/.bkn,并在 network.bkn 的 Network Overview 中列出全部 ID;在根目录添加该网络的 SKILL.md。完成后必须交叉检查并运行 kweaver bkn validate <dir>,通过后可选用 kweaver bkn push <dir> 导入。push 可选 --branch main 与 -bd <business-domain>,未指定时 CLI 自动解析业务域。导出用 kweaver bkn pull <kn-id> [<dir>]。CLI 来自 @kweaver-ai/kweaver-sdk,安装命令 npm install -g @kweaver-ai/kweaver-sdk,要求 Node.js 22+;已有有效令牌时无需重复 kweaver auth login,否则先执行 kweaver auth login <platform-url>。

限制:校验必须通过才能交付或上传,未改动 .bkn 文件时无需重复校验;业务规则必须放在规范允许的位置(网络级、类型级、属性级),不得添加标准章节外的 Markdown;ID 用小写字母、数字和下划线,文件名与 ID 一致;参数绑定 Source 取值 property、input 或 const。平台认证、计费与价格等信息暂未提供。