SuperAPI AI 工具集

create-bkn

通用与其它

查看项目

更新于 10-16 03:05

技能介绍

用途:按 BKN v2.0.1 规范生成结构正确的业务知识网络定义目录(Markdown + YAML frontmatter),一个定义一个文件,放在对应类型子目录中。与 openbkn 技能配合:create-bkn 负责编写 .bkn 文件,之后由 openbkn 执行 openbkn auth login 及 openbkn bkn push / pull。

目录结构:{network_dir}/ 下包含 SKILL.md、network.bkn、可选 CHECKSUM,以及 object_types/、relation_types/、action_types/、concept_groups/,可选 data/(示例数据,validate/push 不读取)。

主要流程:收集对象、关系、动作及可选概念组需求;阅读 references/SPECIFICATION.llm.md 规范;从 assets/templates/ 复制或改写模板;创建 network.bkn 根文件;逐一定义 object_types/.bkn、relation_types/.bkn、action_types/.bkn,可选 concept_groups/.bkn;在 Network Overview 中列出全部 ID;在 BKN 目录根添加 SKILL.md(与 network.bkn 同目录,面向智能体的索引);交叉检查验证清单与业务规则位置;最后运行 openbkn bkn validate <dir> 校验,可选 openbkn bkn push <dir> 导入。

依赖:需来自 @openbkn/bkn-sdk 的 openbkn CLI,即 npm install -g @openbkn/bkn-sdk,Node.js 22.19.0+。

命令:openbkn bkn validate <dir>(离线,无需登录,交付或上传前必须通过);openbkn bkn push <dir> [--branch main];导出用 openbkn bkn pull <kn-id> [<dir>]。平台授权不必预先检查 openbkn auth status,直接 push,仅在出现 401 / not authorized 时执行 openbkn auth login <platform-url> 后重试。若该目录已通过 validate 且未改动 .bkn 文件,push 前无需重复校验。

命名与规则:ID 使用小写字母、数字和下划线,文件名为 {id}.bkn 且置于对应文件夹;frontmatter 至少含 type、id、name;标题层级为 # 网络标题、## 类型块、### 章节、#### 逻辑属性,不得跳级。业务规则须放在规范允许的位置:网络级写在 network.bkn 中 # {title} 之后、结构化章节之前;类型级写在各类型文件 ## ObjectType: 等之后、首个 ### 之前,不得放入 frontmatter;属性级写在 Data Properties 表 Description 列。不要新增标准章节之外的 Markdown 内容。

校验要求:network.bkn 置于根目录且 frontmatter 符合规范;每个 .bkn 有有效 YAML frontmatter;Network Overview 列出全部定义 ID 且无遗漏或多余;关系/动作引用存在的对象类型 ID,概念组仅列出已存在对象;参数绑定 Source 取值为 property | input | const,YAML 块可解析;业务规则仅出现在允许位置。注意 capabilities: 章节不会导致校验或 push 失败,需查看 capabilities.skipped 与警告,其中条目表示未绑定任何平台,格式错误的章节会被整体忽略。

输出约束:直接输出原始 .bkn 内容,不要整体包进代码块;ID 在各关系中保持一致复用;ID 为小写加下划线,显示文本除特别要求外用中文;按规范保持标题顺序。示例见 references/examples/k8s-network/。

限制:资料未提供价格、平台覆盖范围及实际使用效果信息。