360 Secure SkillHub
360 安全技能中心

Semantic Creator — Interface to Governed Semantic Layer (Meta-Skill)

核心功能是按四阶段串行构建受治理语义层,仅依托接口证据,不臆造内容,通过HTML决策工作台让用户确认决策。典型场景为用户需语义层、维度建模、OKF或本体时使用。输入为REST/OpenAPI、CLI、表/DDL等接口契约,输出默认Google OKF bundle,可选Kimball星型YAML,最终经校验确保合规。

agenticweb4
agenticweb4
热度 12.82
最近更新 2026-08-01 17:17:45
分类:数据依赖:读写文件 / 内部调用大模型应用场景:数据处理 / API 集成 / 报告撰写 / 模板

安装技能

复制下面的话术发给你的 Agent,它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill: npx secure-skills-cli add semantic-creator
Metadata
name
semantic-creator
description
Builds evidence-only Kimball semantic layers from APIs, CLIs, or tables with an HTML decision workbench; emits OKF/YAML. Use this skill when users request semantic layers, dimensional models, ontology, OKF, 语义层、接口转语义、维度建模或本体.
license
Apache-2.0
metadata
{"version":"0.5.1"}

Semantic Creator(接口 → 语义层 元技能)

把接口契约(REST/OpenAPI、CLI、表/DDL)一次通过地建成受治理语义层。四个阶段严格串行,每阶段一个参考文件、一组退出条件——满足才前进,不满足不硬闯:

Phase 1 Ingest → Phase 2 Review → Phase 3 Emit → Phase 4 Verify
   ingest.md       review.md      emit-okf.md      verify.md
                                  emit-yaml.md

唯一真源是接口。不臆造字段/粒度/枚举/取值;缺证据停下,一次一问。

Workflow

Phase 1 · Ingest(references/ingest.md)

接口归一成「操作清单」,每个 op 判定角色(fact / dimension-lookup)。 退出条件:清单完整,每个 op 有角色与读写标记。

Phase 2 · Review(references/review.md)

将对象拆为原子决策;显式展示目标、候选、证据、风险、依赖与权衡,并在 事实、维度、度量、路由分区提供固定 YAGNI 判断指导。生成 model JSON 注入 assets/review-template.html,由用户确认、选择、修正、补证或拒绝;反馈写入 amendments.md 后重出报告。 退出条件:收到 approved:true,且无未决或阻塞项。出报告后必须停下; 未批准禁止进入 Phase 3。

Phase 3 · Emit(references/emit-okf.md 默认 / references/emit-yaml.md 可选)

默认生成 Google OKF v0.1 bundle;用户明确要求时生成 repo-YAML(Kimball 星型)。字段语义两个目标共享(定义在 emit-yaml.md §2–§4)。≥2 个 bundle 时生成薄根索引。 退出条件:产物文件完整落盘。

Phase 4 · Verify(references/verify.md)

跑结构检查 + 语义 lint +(如导出 OKF)OKF 硬约束,逐条回报 pass/fail。 退出条件:全部 pass;不可机械修复的 fail → 回 Phase 2 One blocking ask,不静默通过。

Critical Rules

  1. Evidence-only — 字段/粒度/枚举/取值仅来自接口;缺证据写 TODO(verify) 并列入待确认,不编造。
  2. Grain first — 未锁 grain 不挂维度、不写度量。
  3. One blocking ask — 仅在改变建模结果处停(一次一问,带候选),不连环问;批量确认走 HTML 评审。
  4. Layer split — 形态/路由/粒度归语义层;可键入或读取的取值(枚举、code、字段路径、命令)归契约层,语义层只指向。
  5. Stable names — 事实/维度名确认后不重命名(OKF 概念 ID = 文件路径,改名即断链)。
  6. Decision gate — 所有决定初始 pending,不得默认通过。Phase 2 出报告后 停下;仅用户回传 approved:true 且无未决/阻塞项时进入 Phase 3。

Reference Index(按阶段加载)

阶段 文件
Phase 1 物料归一 + 角色判定 references/ingest.md
Phase 2 决策建模 + HTML 工作台 + amendments references/review.md
Phase 3 默认目标 OKF 布局/映射 references/emit-okf.md
Phase 3 可选目标 YAML + 共享字段语义 references/emit-yaml.md
Phase 4 全部校验 + 升级回路 references/verify.md
端到端样例 references/examples.md