SuperAPI AI 工具集

07-design-validation

设计与创作

查看项目

更新于 10-15 20:32

技能介绍

用途:该技能用于 Gold 层设计阶段的一致性校验(Phase 8),在进入实现前发现 YAML schema、Mermaid ERD、COLUMN_LINEAGE.csv 与 PK/FK 约束之间的不一致,避免把设计缺陷带入实现。

主要能力:包含四类校验。1)YAML↔ERD 一致性:检查 ERD 中每个列都存在于对应 YAML schema,反之亦然,并报告表名不一致。2)YAML↔血缘 CSV 一致性:检查每个 Gold 列是否在 COLUMN_LINEAGE.csv 中有条目,列出缺失与多余的血缘记录。3)PK/FK 引用一致性:检查每个外键列存在于本表、引用表存在、被引用列是目标表的主键。4)YAML 必填字段:检查 clustering: auto、delta.enableChangeDataFeed、delta.enableRowTracking、delta.autoOptimize.optimizeWrite、delta.autoOptimize.autoCompact、layer: gold,以及主键列 nullable: false、事实表 grain 是否记录。

使用方式:按项目目录约定读取 gold_layer_design/yaml、gold_layer_design/erd_master.md、gold_layer_design/COLUMN_LINEAGE.csv,依次运行四类校验并汇总结果;最终输出分类的通过/失败报告与需修复的不一致清单。资料未提供具体安装命令或运行入口。

适用场景:完成 Gold 层设计工作流 Phase 8、在交接实现前做预交付检查、迭代修改设计产物后重新校验。

限制:仅覆盖设计阶段静态产物交叉校验,不涉及运行时 DataFrame 与 DDL 的校验(另有实现阶段技能);资料中“33% 实现 bug”等数字为原文陈述,未提供来源与统计口径。相关文件与关联技能的具体内容暂未在资料中提供。