我给 AI 写了一套“规矩“:数仓开发骨架 Ware-Smith 的设计思考(前言)
2026/7/8 3:05:36 网站建设 项目流程

Ware-Smith

AI-Native Data Modeling Skeleton — 让 AI 像老师傅一样做数仓开发

不是又一个 Text-to-SQL 工具,而是一套让 AI Agent 遵守工程纪律、积累领域经验、安全可控地完成数仓全生命周期开发的知识骨架。


一句话定位

Ware-Smith是一套基于 AI IDE Skill 体系的开源数据建模骨架(Skeleton),把数仓需求开发的六个阶段(PRD → 探查 → 建模 → SQL → 校验 → 上线)封装为可插拔、可独立使用、共享同一套规范的 AI Skill 流水线。

它不生产 AI 模型,不绑定特定 LLM——它解决的是:当你把数据开发交给 AI 时,如何保证它不乱来。


为什么需要它

行业现状Ware-Smith 的回答
Text-to-SQL 只管"写出来",不管"写得对"全链路闸门(G0→G3),否决项不可跳过
AI 生成的表名/字段名随心所欲词根词典 + 命名规范强制约束,未匹配的标记"待审批"
一个 Prompt 塞所有规范,超长且脆弱知识分层
需求到上线的中间环节全靠人盯状态管理 + 断点恢复
AI 不理解你的业务(什么是"良率"?什么是"工单"?)团队能力包(领域知识)
改一个字段,下游炸了谁负责?破坏性变更强制安全评估,配 ROLLBACK + 影响通知

设计哲学

1. 知识即约束(Knowledge as Guardrails)

AI 不需要"更聪明",它需要"更有纪律"。

Ware-Smith 的核心信念:把规范编码为可执行的知识文件,而非依赖 Prompt Engineering 的口头约定。词根词典、闸门规则、安全红线——这些不是"建议",是硬约束。

2. 分层治理(Layered Governance)

3. 意图路由(Intent-Driven Routing)

AI 不是被动等指令,而是主动识别用户意图,自动匹配最合适的执行路径:

用户输入 │ ▼ 意图分类(skill-router) ├─ 明确动作("设计这张表") → 精确匹配 → 单能力 Skill ├─ 业务概念("OEE 怎么算") → 模糊匹配 → 判断指标是否已有 → 路由 ├─ 完整需求("从头开始做") → 全流程 Pipeline └─ 歧义不明 → 主动追问,禁止降级猜测

核心原则:涉及新建表、新建指标、变更口径的任务,不允许走直接对话——必须激活 Skill。歧义时问而不是降级。

4. 语义本地化,技术走 API(Semantics Local, Tech via API)

本地知识 = AI 的"大脑"(理解口径、消歧、经验) 平台 API = AI 的"眼睛"(表结构、血缘、数据量)

不把整个元数据库搬进 Context——只存 API 给不了的语义知识(指标口径、聚合规则、编码对齐坑)。

5. 安全前置(Shift-Left Safety)

破坏性变更(改口径 / 改粒度 / 删有引用字段)在设计阶段就被拦截,而非上线时才发现。change-safety-guard自动触发,产出影响范围 + ROLLBACK 策略 + Owner 通知清单。


核心架构

与业界方案的对比

维度Text-to-SQL 工具AI Copilot 插件DataOps 平台 AI 模块Ware-Smith
覆盖范围写 SQL代码补全/解释端到端但锁定在平台内(离开平台即失效)全生命周期(PRD→上线,IDE 原生不锁平台)
规范保障无/弱 Prompt规则由平台定义,团队只能配不能改底层逻辑知识文件 + 闸门双保险(团队完全自主)
领域知识依赖上下文窗口依赖上下文窗口平台提供通用模板,深度定制要等厂商排期可插拔能力包(团队自维护,即时生效)
安全机制依赖审批流,设计错误到提交时才暴露设计阶段拦截+ 强制评估(Shift-Left)
可扩展性改 Prompt改 Prompt平台闭源,扩展受限于厂商 API 开放节奏开放骨架:加文件即生效
状态管理平台内闭环,换工具链状态不可迁移JSON 状态机+ 断点恢复(纯文件可 Git)
与 LLM 耦合绑定平台内置模型,换模型成本高零耦合(纯知识文件,模型随换随用)

目录结构


快速开始

30 秒体验

  1. 克隆本仓库到 AI IDE 工作区
  2. 打开对话,说:“帮我给’实付金额’起个符合规范的字段名”
  3. AI 自动加载基线规范(steering),查词根词典,返回actual_pay_amt+ DECIMAL 类型 + COMMENT

→ 你刚体验了"直接对话"模式,零配置,规范已生效。


团队扩展(只需提供素材)

不需要手动填 YAML,不需要理解骨架内部结构。激活knowledge-curatorSkill,把素材丢给它:

``
激活 knowledge-curator,说:

“帮我把这段会议纪要里的经验整理到能力包”
“这个项目上线后踩了个坑,记一下”
“我们组新定了一个指标口径,录入进去”
“把这份源系统对接文档提取成知识”


理论基础

本骨架的设计汲取了以下工程思想:

  • Data Mesh:团队能力包 = Domain Ownership + Self-Serve Data Platform 的实践
  • Knowledge Engineering:语义层(metrics + vocabulary + dimensions)= 将隐性知识显性化
  • Infrastructure as Code:规范即代码(Knowledge as Code),版本化、可回滚、可审计

Roadmap

  • 核心骨架 + Skill + 共享资源层
  • 制造域示范能力包
  • 知识地图可视化
  • 更多领域能力包(供应链/财务)
  • MCP 服务端集成(Hive / 数据地图)
  • CI/CD 集成(Git Hook + 闸门自动化)
  • 多语言 README(English)
  • 能力包市场(团队间共享)


Ware-Smith:不是替代数据开发者,而是让 AI 成为一个守规矩的数据开发搭子。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询