SuperAPI AI 工具集

naming-tagging-standards

数据与分析

查看项目

更新于 10-15 20:33

技能介绍

用途:为 Databricks 资产建立企业级命名、SQL 注释与成本/治理标签标准,供编码代理遵循。

主要能力: 命名:全对象用 snake_case;表按层(bronze_、silver_)或实体类型(dim_、fact_)加前缀;仅允许 id、ts、dt、amt 等批准缩写,禁止 cust、prod 等。Catalog 用 {env}_{domain}catalog,Schema 用 {layer} 或 {domain}{layer},约束、函数、Job、Pipeline 均有格式约定。 注释:所有 DDL 用 /* / 块注释;表与列 COMMENT 采用双用途格式 [定义]. Business: [用途]. Technical: [细节];TVF 用 v3.0 结构化格式;指标视图用 YAML comment。 标签:工作流必填 team、cost_center、environment(固定为 ${bundle.target});PII 列用 Databricks Data Classification 的 class. 系统治理标签(如 class.email_address);Catalog/Schema/Table 用 UC 治理标签;Serverless 资源须用批准的预算策略。

使用方式:代理先扫描 context/ 目录中的客户标签标准(YAML、JSON、CSV、Markdown、纯文本或自由格式均可),归一化为内部规范模式;无配置或有缺项时按智能默认推导(team 默认 data-engineering,cost_center 为 REVIEW-REQUIRED 并加 TODO,project 从 schema/catalog/repo 推断等)。PII 始终按列名模式推断,客户配置可覆盖或抑制。

适用场景:采用 Unity Catalog 与 Asset Bundles 的 Databricks 数据工程、治理与成本管理项目。限制:资料未提供该技能的具体安装命令、收费方式与运行平台要求。