| name | dwm-matrix |
| description | Use when the user asks to "构建总线矩阵", "数仓建模", "总线矩阵", "矩阵验证", "bus matrix", or discusses data warehouse bus matrix construction, matrix assembly, validation, or delivery. This is the orchestrator that coordinates dwm-business-process, dwm-dimension. |
| version | 3.0.0 |
构建总线矩阵
定位
编排 dwm-business-process / dwm-dimension 两个 Skill，基于上游元数据产出完成总线矩阵的组装与验证。
基于《数据仓库工具箱》(Kimball) 四步法与《阿里巴巴大数据之路》分层实践。
前置输入（上游产出）
| 文件 | 路径 | 提供信息 |
|---|
| 源表元数据 | output/metadata_parse/all_tables_metadata.xlsx | 字段名、数据类型、主键、外键、外键引用、字段空值率、字段角色 |
| ODS 表清单 | output/ods_generator/all_tables_metadata_ods.xlsx | 原表名、新表名（ODS）、主键、外键、DDL |
编排流程
上游产出（metadata_parse + ods_generator）
↓
dwm-business-process 选择业务过程 + 声明粒度 + 确认事实 + DWD spec
↓
dwm-dimension 确认维度 + DIM spec
↓
dwm-matrix 验证 + 生成总线矩阵（本 Skill）
本 Skill 自身职责
验证（交互过程，不持久化）
- 粒度唯一性验证（每个业务过程）
- JOIN 验证（核心维度 JOIN 缺失率 ≤ 1%）
- 口径验证（一致性维度跨事实表口径一致）
- 应连未连检查
产出
输入依赖
| 输入项 | 来源 |
|---|
output/metadata_parse/all_tables_metadata.xlsx | 上游元数据解析 |
output/dwm-bus-matrix/dwm_bp_business_process.csv | dwm-business-process |
output/dwm-bus-matrix/dwm_bp_subject_area.csv | dwm-business-process |
output/dwm-bus-matrix/dwm_dim_spec.csv | dwm-dimension |
产出物
| 产出物 | 说明 | 输出路径 |
|---|
dwm_bus_matrix.xlsx | 总线矩阵（事实 × 维度交叉表） | output/dwm-bus-matrix/ |
回退规则
| 当前步骤 | 回退目标 | 触发条件 |
|---|
| dwm-business-process | 上游 metadata_parse | 字段画像有误导致表角色判断错误 |
| dwm-dimension | 上游 metadata_parse | 外键画像有误导致维度关联错误 |
| dwm-matrix | dwm-dimension | 应连未连或维度口径不一致 |
| dwm-matrix | dwm-business-process | 聚合结果违反业务常识或度量归属有误 |
回退原则：最小回退、影响评估、防循环（同一问题不超过 2 次）。
术语统一
| 用语 | 含义 |
|---|
| 主题域 | 业务过程按相似性归组后的分类 |
| 主题域编码 | 2~3 个大写字母（如 TRD），用于表命名 |
禁用"业务域""数据域"，统一收敛为"主题域"。
CSV 工具与矩阵生成
import sys
sys.path.insert(0, ".claude/skills/dwm-shared/scripts")
from read_csv import read_csv
from write_csv import write_csv
python .claude/skills/dwm-matrix/scripts/write_bus_matrix.py \
--business-process output/dwm-bus-matrix/dwm_bp_business_process.csv \
--subject-area output/dwm-bus-matrix/dwm_bp_subject_area.csv \
--dim-registry output/dwm-bus-matrix/dwm_dim_spec.csv \
--field-metadata output/metadata_parse/all_tables_metadata.xlsx \
--output output/dwm-bus-matrix/dwm_bus_matrix.xlsx \
--version v1.0
代码编写规范
涉及以下场景时，通过 use context7 获取最新文档再编写代码：
- 编写矩阵验证 SQL（JOIN 缺失率、粒度唯一性）
- 安装或调用 openpyxl 生成 Excel 文件
详细规格
Read references/matrix-assembly.md for validation procedures, bus matrix Excel schema, and rollback rules.
