Bkn map

Skill kweaver-ai/kweaver-dip/skills/bkn-creator/internal/bkn-map

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.

Install

npx -y skills add kweaver-ai/kweaver-dip --skill bkn-map

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

What its author says it does

Copied from the file, not written here

属性到字段映射 + 覆盖率计算 + 完备性放行。

SKILL.md

4.4 KB, as published. Nobody here has run it

属性映射

公约：../_shared/contract.md | 映射规则：references/mapping-rules.md

做什么

给定已绑定对象和视图字段 schema，为每个属性确定映射状态，计算覆盖率，判定是否放行。

输入

binding_decision_list：bkn-bind 的输出（仅处理 bound 对象）
relation_binding_result：bkn-relation-bind 的输出（仅处理 confirmed 关系）
object_draft_list：对象清单（含属性）
view_schema_map：已绑定视图的字段 schema + 外键信息

流程

对象属性映射

属性回灌：以原始文本 + 绑定视图字段为输入，重建属性候选
- 分层标注：core_business（原始文本存在）/ view_derived（仅视图中有）/ technical_excluded（纯技术字段）
- 输出差异动作：keep / add / rename / merge / drop_candidate
- 属性名对齐：若 draft 阶段使用的属性名与视图字段名不一致，执行 rename 操作，将 draft 属性名改为视图实际字段名
- 无已绑定视图时输出空差异，标注原因
映射判定：每个属性三态之一
- mapped：有明确字段来源、语义一致、类型兼容
- waived：有依据的豁免（非必填/业务确认暂不绑定）
- blocked：无可接受字段/类型冲突/多候选无法裁决
覆盖率：coverage = (mapped + waived) / total
质量评定：
- blocked_count = 0 AND coverage = 100% → mapping_quality: full
- blocked_count = 0 AND coverage >= 80% → mapping_quality: partial（有豁免项）
- blocked_count > 0 OR coverage < 80% → mapping_quality: needs_work
mapping_quality 作为评分输入传给 bkn-review，不单独阻断 pipeline。Pipeline 放行权由 bkn-review 的综合评分决定。

mapping_quality 非 full 时提供互斥策略：

A（BKN 优先）：补映射后重跑
B（视图优先）：按视图重构属性后重跑
C（混合治理）：高价值差异增补，其余豁免

详细规则见 references/mapping-rules.md

关系类 View Property 映射（新增）

仅处理 relation_binding_result.data_view_relations 中 status: confirmed 的关系：

Source Mapping 映射：
- 输入：source_mapping_rules（起点属性 → 中间视图字段）
- 验证：起点属性存在于起点对象的 Data Properties
- 验证：中间视图字段存在于中间视图 schema
- 映射状态：mapped / blocked
Target Mapping 映射：
- 输入：target_mapping_rules（中间视图字段 → 终点属性）
- 验证：中间视图字段存在于中间视图 schema
- 验证：终点属性存在于终点对象的 Data Properties
- 映射状态：mapped / blocked
关系映射质量评定：
- 所有 Source/Target Mapping 都 mapped → relation_mapping_quality: full
- 有 blocked → relation_mapping_quality: partial

跳过条件：

relation_binding_result 为空或不存在
无 confirmed 的 data_view 类型关系

输出

property_regen_summary: {keep, add, rename, merge, drop_candidate}
property_mapping_draft:
  - object_name: ""
    mapped_count: 0
    waived_count: 0
    blocked_count: 0
    coverage: 0.0
    rows: [{property_name, status, view_id, field_path, confidence, reason}]
mapping_gate_summary: {coverage, blocked_count, mapping_quality, recommended_strategy}

# 新增：关系类映射结果
relation_mapping_draft:
  - 关系ID: ""
    关系名称: ""
    关系类型: direct | data_view
    intermediate_view_id: ""      # 仅 data_view 类型
    source_mapping:
      - source_property: ""
        view_property: ""
        status: mapped | blocked
        reason: ""
    target_mapping:
      - view_property: ""
        target_property: ""
        status: mapped | blocked
        reason: ""
    relation_mapping_quality: full | partial | skipped
relation_mapping_summary:
  total_relations: 0
  mapped_relations: 0
  blocked_relations: 0
  skipped_relations: 0            # pending 关系，跳过映射

约束

属性回灌不可跳过，即使绑定率已达标
不将"猜测"标为 mapped
不将"暂无字段"标为 waived（waived 是有依据的豁免）
coverage 必须可追溯到逐属性证据
本 skill 执行完成后，pipeline 负责将 map_completed: true 写入 pipeline_state.yaml，本 skill 不直接写入该文件

What its author says it does

SKILL.md

属性映射

做什么

输入

流程

对象属性映射

关系类 View Property 映射（新增）

输出

约束

Keep looking