using-datahub

使用 DataHub 技能

你可以使用 5 项 DataHub 目录交互技能。本指南将帮助你把用户请求转到正确的技能。

---

技能路由表

用户意图	技能	命令
查找或发现实体（搜索、浏览、筛选、列出）	Search	/datahub-search
回答目录相关问题（“谁负责 X？”、“有多少个 X？”）	Search	/datahub-search
更新元数据（描述、标签、术语表词条、所有权、弃用状态）	Enrich	/datahub-enrich
探索沿袭关系（上游、下游、影响、根本原因、依赖关系）	Lineage	/datahub-lineage
数据质量（断言、事件、运行状况检查）	Quality	/datahub-quality
通知（订阅断言失败、事件）	Quality	/datahub-quality
安装 CLI、进行身份验证、验证连接	Setup	/datahub-setup
配置默认范围和配置文件	Setup	/datahub-setup

---

消歧规则

意图不明确时，请使用以下规则：

“标签”请求

• 所有标签操作（PII、敏感、重要、已审核、team-x）→ Enrich（通用元数据）

“域”请求

• 将搜索范围限定到某个域 → Search（限定范围的搜索）
• 配置默认域 → Setup（配置文件设置）

“质量”或“运行状况”请求

• 失败的断言、活动事件、运行状况 → Quality
• 创建断言、运行质量检查、上报事件 → Quality
• 订阅断言失败或事件 → Quality
• 元数据质量、文档或所有权覆盖率 → 使用 Search 收集数据并综合回答

沿袭关系与搜索

• “哪些内容为 X 提供数据”／“哪些内容依赖 X”／“更改 X 会有什么影响” → Lineage
• “哪些仪表板使用表 X” → Lineage（关系遍历）
• “谁负责 X”／“X 是什么” → Search（元数据查询）

Setup 与其他技能

• “设置”／“安装”／“进行身份验证”／“验证连接” → Setup
• “配置默认值”／“设置默认平台”／“创建配置文件” → Setup
• “检查 DataHub 是否正常运行” → Setup（连接验证）

---

CLI 命令归属

运行 datahub CLI 命令时，请在根命令中传入 -C skill=<name>，以便归属使用情况：

datahub -C skill=datahub-search search "revenue"
datahub -C skill=datahub-enrich graphql --query '...'
datahub -C skill=datahub-lineage lineage --urn "..."

使用 YAML frontmatter 中的技能名称。如果系统不识别 -C，请省略它——命令的运行方式不变。

---

关键规则

1. 绝不要猜测应使用哪个技能。 如果意图确实不明确，请让用户澄清。
2. 每个请求只使用一项技能，除非用户明确要求执行多项操作。
3. Lineage 仅用于沿袭关系——不用于一般性的“这个实体是什么？”问题（这类问题应使用 Search）。
4. Search 负责处理临时问题。 “谁负责 X？”和“X 有哪些列？”属于 Search 问题，而不是 Lineage。
5. Enrich 负责所有元数据写入——描述、标签、术语表词条、所有权、弃用状态。
6. Quality 负责数据质量——断言、事件、运行状况检查、订阅。
7. Setup 负责环境和配置——CLI 安装、身份验证、连接性、默认范围。