bkn-modeling 是什么？

非常适合需要统一数据访问和Business Knowledge Network建模能力的AI代理。本地化技能摘要： bkn-modeling helps AI agents handle repository-specific developer workflows with documented implementation details.

如何安装 bkn-modeling？

运行命令：npx killer-skills add kweaver-ai/adp。支持 Cursor、Windsurf、VS Code、Claude Code 等 19+ IDE/Agent。

bkn-modeling 适用于哪些场景？

典型场景包括：创建具有实体、关系和动作定义的新知识网络、编排跨异构数据源的数据处理、为业务知识网络建模生成BKN文件。

bkn-modeling 支持哪些 IDE 或 Agent？

该技能兼容 Cursor, Windsurf, VS Code, Trae, Claude Code, OpenClaw, Aider, Codex, OpenCode, Goose, Cline, Roo Code, Kiro, Augment Code, Continue, GitHub Copilot, Sourcegraph Cody, and Amazon Q Developer。可使用 Killer-Skills CLI 一条命令通用安装。

bkn-modeling 有哪些限制？

需要了解BKN文件结构和语法；仅限业务知识网络建模的使用场景。

bkn-modeling

安装 bkn-modeling，这是一款面向AI agent workflows and automation的 AI Agent Skill。查看功能、使用场景、限制条件与安装命令。

SKILL.md

Readonly

Upstream Repository Material

The section below comes from the upstream repository. Use it as supporting material alongside the fit, use-case, and installation summary on this page.

Upstream Source

BKN 业务知识网络建模

Name: bkn-modeling
Availability: InStock
Author: kweaver-ai

辅助编写 BKN (Business Knowledge Network) 业务知识网络建模文件。

快速开始

创建新的知识网络

使用模板创建：docs/ontology/bkn_docs/templates/network.bkn.template
参考样例：docs/ontology/bkn_docs/examples/k8s-topology.bkn
查阅规范：docs/ontology/bkn_docs/SPECIFICATION.md

BKN 文件结构

markdown
1---
2type: network
3id: my-network
4name: 我的网络
5version: 1.0.0
6---
7
8# 网络标题
9
10## Entity: entity_id
11...
12
13## Relation: relation_id
14...
15
16## Action: action_id
17...

三种类型

实体类 (Entity)

描述业务对象，直接映射数据视图：

markdown
1## Entity: pod
2
3**Pod实例** - 描述
4
5### 数据来源
6
7| 类型 | ID |
8|------|-----|
9| data_view | view_id |
10
11> **主键**: `id` | **显示属性**: `pod_name`

配置模式:

完全映射: 只声明数据来源，自动继承所有字段
属性覆盖: 仅声明需要特殊配置的属性
完整定义: 完整声明所有属性（精细控制）

关系类 (Relation)

描述两个实体之间的关联：

markdown
1## Relation: pod_belongs_node
2
3**Pod属于节点**
4
5| 起点 | 终点 | 类型 |
6|------|------|------|
7| pod | node | direct |
8
9### 映射规则
10
11| 起点属性 | 终点属性 |
12|----------|----------|
13| pod_node_name | node_name |

行动类 (Action)

描述可执行的操作：

markdown
1## Action: restart_pod
2
3**重启Pod**
4
5| 绑定实体 | 行动类型 |
6|----------|----------|
7| pod | modify |
8
9### 触发条件
10
11```yaml
12field: pod_status
13operation: in
14value: [Unknown, Failed]
15`` `
16
17### 工具配置
18
19| 类型 | 工具ID |
20|------|--------|
21| tool | kubectl_delete_pod |
22
23### 参数绑定
24
25| 参数 | 来源 | 绑定 |
26|------|------|------|
27| pod | property | pod_name |

常用操作

添加实体

在 # 实体定义 section 下添加 ## Entity: {id}
声明数据来源（必须）
声明主键和显示属性（必须）
可选：属性覆盖、逻辑属性

添加关系

在 # 关系定义 section 下添加 ## Relation: {id}
声明起点、终点、类型（必须）
声明映射规则（必须）

添加行动

在 # 行动定义 section 下添加 ## Action: {id}
声明绑定实体和行动类型（必须）
声明工具配置和参数绑定（必须）
可选：触发条件、调度配置

增量导入

BKN 支持动态增量导入，任何 .bkn 文件可直接导入到已有的知识网络。

文件类型

type	用途
`entity`	单个实体，独立文件
`relation`	单个关系，独立文件
`action`	单个行动，独立文件
`fragment`	混合片段，包含多个定义
`delete`	删除标记

导入行为

ID 不存在: 新增定义
ID 已存在: 更新定义（覆盖）
type: delete: 删除指定定义

稳定性要求（重要）

幂等：同一文件重复导入，结果必须一致
确定性：同一批输入文件（不依赖目录遍历顺序）导入结果必须一致
冲突处理：同一个 (network, type, id) 在同一批次重复定义时，默认应 fail-fast（推荐）

行动治理（重要）

行动连接执行面（tool/mcp），建议遵循：

导入不等于启用；启用/执行需要独立权限与审计
Action 文档中明确：触发、影响范围、权限与前置条件、回滚/失败策略

新增实体示例

创建独立文件 deployment.bkn:

markdown
1---
2type: entity
3id: deployment
4name: Deployment
5network: k8s-network
6---
7
8# Deployment
9
10## 数据来源
11
12| 类型 | ID |
13|------|-----|
14| data_view | deployment_view |
15
16> **主键**: `id` | **显示属性**: `deployment_name`

导入后自动添加到 k8s-network。

命名规范

类型	格式	示例
网络 ID	snake_case	`k8s_topology`
实体 ID	snake_case	`pod`, `node`
关系 ID	snake_case	`pod_belongs_node`
行动 ID	snake_case	`restart_pod`

验证清单

编写完成后检查：

Frontmatter 包含 type, id, name, version
每个实体有数据来源、主键、显示属性
每个关系有起点、终点、映射规则
每个行动有绑定实体、工具配置、参数绑定
ID 使用 snake_case 格式
表格格式正确

bkn-modeling — for Claude Code bkn-modeling, community, for Claude Code, ide skills, 2. 参考样例：, 3. 查阅规范：, ### BKN 文件结构, Business, Knowledge, Network

关于此技能

功能特性

# 核心主题

技能概览

核心价值

适用 Agent 类型

↓ 赋予的主要能力 · bkn-modeling

! 使用限制与门槛

关于来源内容

Browser Sandbox Environment

⚡️ Ready to unleash?

常见问题与安装步骤

? FAQ