{"id":"107f5393-b506-4a51-8915-3d3de97ab2ce","shortId":"K7KjFs","kind":"skill","title":"bkn-modeling-advisor","tagline":"指导业务知识网络（BKN）建模，输出符合 BKN 2.0.0 的对象类型、关系类型、操作类型、风险类型与概念分组定义。适用于用户提出本体设计、知识网络建模、实体关系梳理、Action 设计、Schema 评审、从文档提取初稿或扩展现有 BKN 的场景。","description":"# BKN Modeling Advisor\n\n## 适用场景\n\n当用户出现以下意图时使用本技能：\n- 从零设计一个 BKN\n- 扩展/重构已有 BKN\n- 从 PRD、流程文档提取本体初稿\n- 评审 BKN 结构是否合理\n- 讨论对象、关系、Action、风险与治理建模\n\n## 工作模式\n\n先识别模式，再进入流程：\n\n1. `new`：无现成 BKN，从业务场景开始建模\n2. `import`：已有 BKN，做增量设计或评审\n3. `from_doc`：用户提供文档，先抽取初稿再补齐\n\n## 交互原则\n\n- 每次只问一个关键问题，等待回答后推进\n- 优先使用业务语言，不要求用户理解 JSON 细节\n- 每个阶段结束先复述（Model Narration）再确认\n- 对不确定术语先标记，再请求澄清\n- 出现高风险变更时，强制补齐审批与回滚描述\n\n## 建模流程\n\n按以下阶段推进，`import`/`from_doc` 可从中间阶段切入。\n\n### Phase 1：领域锚定\n\n收集并确认：\n- `network.id`\n- `network.name`\n- `network.description`\n- `business_domain`（如采购、库存、计划、质量）\n\n### Phase 2：场景走查\n\n让用户描述典型流程，提取候选项：\n- 反复出现的业务名词 -> 候选 `object_type`\n- 状态变化与动作 -> 候选 `action_type`\n- 对象之间的关联 -> 候选 `relation_type`\n\n### Phase 3：对象类型确认\n\n对每个候选对象检查：\n- 是否有独立生命周期\n- 是否有稳定唯一标识（字符串主键）\n- 是否至少有 3 个可追踪属性\n- 是否被多个流程或角色使用\n\n对象输出至少包含：\n- `id`, `name`, `description`\n- `data_properties[]`\n- `keys.primary_keys[]`, `keys.display_key`\n\n### Phase 4：关系类型确认\n\n逐对对象确认：\n- 业务含义是否清晰\n- 基数（1:1 / 1:N / N:1 / N:M）\n- 关系实现类型\n  - `direct`：字段直连，需 `mapping_rules`\n  - `data_view`：需中间视图，需映射定义\n\n如果“关系本身有属性”（如金额、状态、生效日期），优先升级为独立对象，而非直接建 link。\n\n### Phase 5：操作类型确认\n\n为每个操作明确：\n- 谁触发（角色）\n- 改变哪些对象和字段\n- 前置条件（`pre_conditions`）\n- 参数来源（`property` / `input` / `const`）\n- 风险等级（`low` / `medium` / `high`）\n- 是否必须审批（`requires_approval`）\n\n`bound_object.action_type` 仅可取：\n- `add`\n- `modify`\n- `delete`\n- `query`\n\n### Phase 6：可选治理补充\n\n按需补充：\n- `risk_type`：高风险动作的控制策略\n- `concept_group`：对象分组（按业务域/职责）\n\n### Phase 7：完整性审查与导出\n\n导出前逐项检查：\n- 必填字段齐全\n- ID 命名合法（建议仅用 `[a-z0-9_-]`）\n- 引用对象存在且可达\n- 主键/显示键指向有效字段\n- Action 参数绑定完整\n\n## 快速建模准则\n\n### 对象 vs 属性\n\n- 简单特征值（状态、等级、颜色） -> 属性\n- 独立业务实体（可被引用、有生命周期） -> 对象\n\n### 关系 vs 对象\n\n- 仅表示连接 -> 关系\n- 连接本身有业务属性 -> 升级为对象\n\n### Action vs 关系\n\n- 描述“结构关联” -> 关系\n- 描述“状态改变或业务动作” -> Action\n\n### 主键设计\n\n- 必须为字符串\n- 必须稳定且可复算\n- 优先业务单号/编码，避免随机 UUID\n\n## 输出格式\n\n默认输出两段内容：\n\n1. **业务复述版**（给业务方确认）\n2. **BKN 结构草案**（JSON 片段，按节点类型分组）\n\n如用户确认“导出完整文件”，再输出完整 BKN JSON。\n\n## 与 bkn-creator 对接契约（MUST）\n\n当被 `bkn-creator` 委托时，输出必须满足以下契约：\n\n1. 对象分组\n   - `explicit_objects`\n   - `inferred_objects`（每项必须含 `inference_reason`）\n   - `pending_objects`\n2. 关系命名\n   - `relation.name` 必须使用中文业务名\n   - 英文技术标识仅可放在 `relation_id`\n3. 待确认项处理提示\n   - 当 `pending_objects` 非空时，必须附“待确认对象处理建议”（纳入 / 移出 / 保留待确认）\n   - 不得将“待确认对象”直接并入最终确认清单\n4. 交付内容\n   - 业务复述版（可供用户确认）\n   - 结构化建模清单（可供 `bkn-creator` 继续门禁流转）\n\n## 输出模板\n\n### A. 业务复述版\n\n```markdown\n当前模型包含：\n- 核心对象：...\n- 关键关系：...\n- 主要操作：...\n- 高风险点：...\n- 待确认项：...\n```\n\n### B. BKN 结构草案（示例骨架）\n\n```json\n{\n  \"network\": {\n    \"id\": \"example_network\",\n    \"name\": \"示例网络\",\n    \"description\": \"...\"\n  },\n  \"object_types\": [],\n  \"relation_types\": [],\n  \"action_types\": [],\n  \"risk_types\": [],\n  \"concept_groups\": []\n}\n```\n\n## 质量门禁（每轮）\n\n输出前自检：\n- 是否把“状态枚举”误建为对象\n- 是否出现无法解释的缩写字段名\n- 是否有无主键对象\n- 是否有未绑定的 Action 参数\n- 是否遗漏审批/审计要求（高风险场景）\n\n如果任一失败，先修正再输出。\n\n## 需要追问的最小问题集\n\n信息不足时按以下顺序提问：\n1. 网络覆盖范围是什么？\n2. 最核心的 3-5 个业务对象是什么？\n3. 每个对象的唯一标识是什么？\n4. 最关键的 2-3 条对象关系是什么？\n5. 最关键的 2-3 个业务动作是什么？\n\n## 结束标准\n\n满足以下条件才可宣布完成：\n- 用户确认业务复述准确\n- BKN 结构通过完整性检查\n- 待确认项明确列出并已获用户接受（可留 backlog）","tags":["bkn","modeling","advisor","kweaver","dip","kweaver-ai","agent-skills","agents","digital-worker","ontology","openclaw"],"capabilities":["skill","source-kweaver-ai","skill-bkn-modeling-advisor","topic-agent-skills","topic-agents","topic-digital-worker","topic-ontology","topic-openclaw"],"categories":["kweaver-dip"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/kweaver-ai/kweaver-dip/bkn-modeling-advisor","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add kweaver-ai/kweaver-dip","source_repo":"https://github.com/kweaver-ai/kweaver-dip","install_from":"skills.sh"}},"qualityScore":"0.508","qualityRationale":"deterministic score 0.51 from registry signals: · indexed on github topic:agent-skills · 117 github stars · SKILL.md body (2,942 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-02T06:55:19.847Z","embedding":null,"createdAt":"2026-04-18T22:14:43.613Z","updatedAt":"2026-05-02T06:55:19.847Z","lastSeenAt":"2026-05-02T06:55:19.847Z","tsv":"'-3':392,397 '-5':385 '1':48,85,141,142,143,146,262,288,380 '2':53,98,265,299,382,391,396 '2.0.0':10 '3':58,115,122,306,384,387 '4':136,320,389 '5':168,394 '6':196 '7':208 '9':218 'a-z0':215 'action':18,43,108,222,244,252,356,371 'add':191 'advisor':4,27 'approv':187 'b':340 'backlog':406 'bkn':2,6,9,23,25,31,34,39,51,56,266,274,278,284,327,341,402 'bkn-creator':277,283,326 'bkn-modeling-advisor':1 'bound_object.action':188 'busi':91 'concept':202,360 'condit':176 'const':180 'creator':279,285,328 'data':129,155 'delet':193 'descript':128,351 'direct':150 'doc':60,82 'domain':92 'exampl':347 'explicit':290 'group':203,361 'high':184 'id':126,212,305,346 'import':54,80 'infer':292,295 'input':179 'json':68,268,275,344 'key':132,134 'keys.display':133 'keys.primary':131 'link':166 'low':182 'm':148 'map':153 'markdown':333 'medium':183 'model':3,26,71 'modifi':192 'must':281 'n':144,145,147 'name':127,349 'narrat':72 'network':345,348 'network.description':90 'network.id':88 'network.name':89 'new':49 'object':104,291,293,298,310,352 'pend':297,309 'phase':84,97,114,135,167,195,207 'prd':36 'pre':175 'properti':130,178 'queri':194 'reason':296 'relat':112,304,354 'relation.name':301 'requir':186 'risk':199,358 'rule':154 'schema':20 'skill' 'skill-bkn-modeling-advisor' 'source-kweaver-ai' 'topic-agent-skills' 'topic-agents' 'topic-digital-worker' 'topic-ontology' 'topic-openclaw' 'type':105,109,113,189,200,353,355,357,359 'uuid':259 'view':156 'vs':226,238,245 'z0':217 '不得将':317 '不要求用户理解':67 '与':276 '业务含义是否清晰':139 '业务复述版':263,322,332 '个业务动作是什么':398 '个业务对象是什么':386 '个可追踪属性':123 '为每个操作明确':170 '主要操作':337 '主键':220 '主键设计':253 '交互原则':63 '交付内容':321 '仅可取':190 '仅表示连接':240 '从':35 '从业务场景开始建模':52 '从文档提取初稿或扩展现有':22 '从零设计一个':30 '优先业务单号':256 '优先使用业务语言':66 '优先升级为独立对象':164 '保留待确认':316 '信息不足时按以下顺序提问':379 '候选':103,107,111 '做增量设计或评审':57 '先修正再输出':377 '先抽取初稿再补齐':62 '先识别模式':46 '关系':42,237,241,246,249 '关系命名':300 '关系实现类型':149 '关系本身有属性':160 '关系类型':12 '关系类型确认':137 '关键关系':336 '再确认':73 '再请求澄清':75 '再输出完整':273 '再进入流程':47 '出现高风险变更时':76 '前置条件':174 '升级为对象':243 '参数':372 '参数来源':177 '参数绑定完整':223 '反复出现的业务名词':102 '可从中间阶段切入':83 '可供':325 '可供用户确认':323 '可留':405 '可被引用':234 '可选治理补充':197 '命名合法':213 '场景走查':99 '基数':140 '如果':159 '如果任一失败':376 '如用户确认':271 '如采购':93 '如金额':161 '委托时':286 '字段直连':151 '字符串主键':120 '完整性审查与导出':209 '实体关系梳理':17 '审计要求':374 '对不确定术语先标记':74 '对接契约':280 '对每个候选对象检查':117 '对象':225,236,239 '对象之间的关联':110 '对象分组':204,289 '对象类型确认':116 '对象输出至少包含':125 '导出前逐项检查':210 '导出完整文件':272 '属性':227,232 '工作模式':45 '已有':55 '库存':94 '建模':7 '建模流程':78 '建议仅用':214 '引用对象存在且可达':219 '强制补齐审批与回滚描述':77 '当':308 '当前模型包含':334 '当用户出现以下意图时使用本技能':29 '当被':282 '待确认对象':318 '待确认对象处理建议':313 '待确认项':339 '待确认项处理提示':307 '待确认项明确列出并已获用户接受':404 '必填字段齐全':211 '必须为字符串':254 '必须使用中文业务名':302 '必须稳定且可复算':255 '必须附':312 '快速建模准则':224 '扩展':32 '指导业务知识网络':5 '按业务域':205 '按以下阶段推进':79 '按节点类型分组':270 '按需补充':198 '描述':247,250 '提取候选项':101 '操作类型':13 '操作类型确认':169 '收集并确认':87 '改变哪些对象和字段':173 '无现成':50 '是否出现无法解释的缩写字段名':368 '是否必须审批':185 '是否把':365 '是否有无主键对象':369 '是否有未绑定的':370 '是否有独立生命周期':118 '是否有稳定唯一标识':119 '是否至少有':121 '是否被多个流程或角色使用':124 '是否遗漏审批':373 '显示键指向有效字段':221 '最关键的':390,395 '最核心的':383 '有生命周期':235 '条对象关系是什么':393 '核心对象':335 '每个对象的唯一标识是什么':388 '每个阶段结束先复述':70 '每次只问一个关键问题':64 '每轮':363 '每项必须含':294 '流程文档提取本体初稿':37 '满足以下条件才可宣布完成':400 '片段':269 '状态':162,229 '状态变化与动作':106 '状态改变或业务动作':251 '状态枚举':366 '独立业务实体':233 '生效日期':163 '用户提供文档':61 '用户确认业务复述准确':401 '的场景':24 '的对象类型':11 '直接并入最终确认清单':319 '知识网络建模':16 '示例网络':350 '示例骨架':343 '移出':315 '等待回答后推进':65 '等级':230 '简单特征值':228 '纳入':314 '细节':69 '结束标准':399 '结构关联':248 '结构化建模清单':324 '结构是否合理':40 '结构草案':267,342 '结构通过完整性检查':403 '给业务方确认':264 '继续门禁流转':329 '编码':257 '网络覆盖范围是什么':381 '而非直接建':165 '职责':206 '英文技术标识仅可放在':303 '角色':172 '计划':95 '讨论对象':41 '让用户描述典型流程':100 '设计':19 '评审':21,38 '误建为对象':367 '谁触发':171 '质量':96 '质量门禁':362 '输出前自检':364 '输出必须满足以下契约':287 '输出格式':260 '输出模板':330 '输出符合':8 '连接本身有业务属性':242 '适用于用户提出本体设计':15 '适用场景':28 '逐对对象确认':138 '避免随机':258 '重构已有':33 '需':152 '需中间视图':157 '需映射定义':158 '需要追问的最小问题集':378 '非空时':311 '领域锚定':86 '颜色':231 '风险与治理建模':44 '风险等级':181 '风险类型与概念分组定义':14 '高风险动作的控制策略':201 '高风险场景':375 '高风险点':338 '默认输出两段内容':261","prices":[{"id":"de2c6344-724b-4cd0-8155-5644366df7c0","listingId":"107f5393-b506-4a51-8915-3d3de97ab2ce","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"kweaver-ai","category":"kweaver-dip","install_from":"skills.sh"},"createdAt":"2026-04-18T22:14:43.613Z"}],"sources":[{"listingId":"107f5393-b506-4a51-8915-3d3de97ab2ce","source":"github","sourceId":"kweaver-ai/kweaver-dip/bkn-modeling-advisor","sourceUrl":"https://github.com/kweaver-ai/kweaver-dip/tree/main/skills/bkn-modeling-advisor","isPrimary":false,"firstSeenAt":"2026-04-18T22:14:43.613Z","lastSeenAt":"2026-05-02T06:55:19.847Z"}],"details":{"listingId":"107f5393-b506-4a51-8915-3d3de97ab2ce","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"kweaver-ai","slug":"bkn-modeling-advisor","github":{"repo":"kweaver-ai/kweaver-dip","stars":117,"topics":["agent-skills","agents","ai","business-knowledge-network","digital-worker","ontology","openclaw"],"license":"apache-2.0","html_url":"https://github.com/kweaver-ai/kweaver-dip","pushed_at":"2026-05-01T05:38:33Z","description":"KWeaver DIP is an enterprise-level digital employee platform, built on KWeaver Core. It provides an AI-native environment for developing and managing digital employees on business knowledge networks—for enterprise intelligence that is understandable, executable, and governable.","skill_md_sha":"5c0312e25f17f4f782026baf31ccfb852a310b3c","skill_md_path":"skills/bkn-modeling-advisor/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/kweaver-ai/kweaver-dip/tree/main/skills/bkn-modeling-advisor"},"layout":"multi","source":"github","category":"kweaver-dip","frontmatter":{"name":"bkn-modeling-advisor","description":"指导业务知识网络（BKN）建模，输出符合 BKN 2.0.0 的对象类型、关系类型、操作类型、风险类型与概念分组定义。适用于用户提出本体设计、知识网络建模、实体关系梳理、Action 设计、Schema 评审、从文档提取初稿或扩展现有 BKN 的场景。"},"skills_sh_url":"https://skills.sh/kweaver-ai/kweaver-dip/bkn-modeling-advisor"},"updatedAt":"2026-05-02T06:55:19.847Z"}}