$npx -y skills add kweaver-ai/kweaver-dip --skill data-quality基于 Data View 和 Task Center API 的数据质量管理。管理质量规则、查询逻辑视图、创建检测工单。当用户需要数据质量相关操作时使用。
| 1 | # 数据质量管理 |
| 2 | |
| 3 | > **渐进式加载**: [核心概念](./core/core.md) → [快速开始](./guides/quickstart.md) → [详细指南](./guides/detailed-guide.md) |
| 4 | |
| 5 | ## 核心能力 |
| 6 | |
| 7 | | 能力 | 说明 | API 端点 | |
| 8 | |------|------|----------| |
| 9 | | 质量规则 | 质量规则的增删改查 | `/api/data-view/v1/explore-rule` | |
| 10 | | 逻辑视图 | 查询视图列表和字段信息 | `/api/data-view/v1/form-view` | |
| 11 | | 检测工单 | 创建和跟踪检测工单 | `/api/task-center/v1/work-order` | |
| 12 | | 知识网络 | 基于知识网络配置规则 | `/api/ontology-manager/v1` | |
| 13 | |
| 14 | ## 技能入参 |
| 15 | |
| 16 | 技能接受以下入参,大模型在调用技能时应按以下格式传递: |
| 17 | |
| 18 | ```json |
| 19 | { |
| 20 | "query": "用户提问内容(必须)", |
| 21 | "business_docs": ["业务知识文档列表(可选)"], |
| 22 | "business_desc": "业务知识描述文本(可选)", |
| 23 | "context": "其它可用上下文文本(可选)" |
| 24 | } |
| 25 | ``` |
| 26 | |
| 27 | ### 入参说明 |
| 28 | |
| 29 | | 参数名 | 类型 | 必填 | 说明 | |
| 30 | |--------|------|------|------| |
| 31 | | `query` | string | **是** | 用户提问内容,描述用户想要执行的数据质量管理操作 | |
| 32 | | `business_docs` | array | 否 | 业务知识文档列表,用户提供配置质量规则时的业务知识文档 | |
| 33 | | `business_desc` | string | 否 | 业务知识描述文本,用户提供配置质量规则时的业务知识文本描述 | |
| 34 | | `context` | string | 否 | 其它可用上下文文本,用户提供必要的上下文依据 | |
| 35 | |
| 36 | ### 入参使用场景总览 |
| 37 | |
| 38 | | 场景 | query | context | business_desc | business_docs | |
| 39 | |------|-------|---------|---------------|---------------| |
| 40 | | 知识网络质量分析 | ✅ | ✅ | ✅ | ✅ | |
| 41 | | 视图质量查询 | ✅ | ✅ | ✅ | ✅ | |
| 42 | | 规则配置 | ✅ | ✅ | ✅ | ✅ | |
| 43 | | 质量检测 | ✅ | ✅ | - | - | |
| 44 | | 问题诊断 | ✅ | ✅ | - | - | |
| 45 | |
| 46 | ### 入参职责区分 |
| 47 | |
| 48 | **重要**: 各入参有明确的职责分工,不得混用: |
| 49 | |
| 50 | | 入参 | 职责 | 说明 | |
| 51 | |------|------|------| |
| 52 | | `query` | **目标识别(第一优先级)** | 用于确定要分析的知识网络或对象类 | |
| 53 | | `context` | **目标识别(第二优先级)** | 当query中没有明确目标时,从context中提取知识网络或对象类信息 | |
| 54 | | `business_desc` | **规则配置依据** | 仅作为配置质量规则时的业务语义来源 | |
| 55 | | `business_docs` | **规则配置依据** | 仅作为配置质量规则时的业务文档来源 | |
| 56 | |
| 57 | **目标识别优先级**: |
| 58 | ``` |
| 59 | 1. 首先从 query 中提取知识网络/对象类信息 |
| 60 | 2. 如果 query 中没有明确目标,才从 context 中提取 |
| 61 | 3. business_desc 和 business_docs 永远不能用于确定分析目标 |
| 62 | ``` |
| 63 | |
| 64 | ### 使用优先级 |
| 65 | |
| 66 | 1. **query** 始终必须,用于确定用户意图和分析目标 |
| 67 | 2. **context** 用于提供必要的上下文依据,当query无目标时作为分析目标的补充来源 |
| 68 | 3. **business_desc** 仅用于配置质量规则时提供业务语义 |
| 69 | 4. **business_docs** 仅用于配置质量规则时提供业务文档 |
| 70 | |
| 71 | ## 前置条件 |
| 72 | |
| 73 | ```bash |
| 74 | DATA_QUALITY_BASE_URL=https://10.4.134.26 |
| 75 | DATA_QUALITY_AUTH_TOKEN=Bearer xxxxxx |
| 76 | ``` |
| 77 | |
| 78 | **验证**: `GET {BASE_URL}/api/eacp/v1/user/get` |
| 79 | |
| 80 | ## 关键约束 |
| 81 | |
| 82 | > **详细约束请参考**: [核心约束参考](./reference/core-constraints.md) |
| 83 | |
| 84 | 1. **配置优先**: 使用前必须先验证环境变量 |
| 85 | 2. **有据可依**: 规则配置必须有明确的依据 |
| 86 | 3. **配置非空**: 创建规则时 `rule_config` 不能为空 |
| 87 | 4. **技术名称**: `rule_config` 中的 SQL 表达式必须使用字段技术名称 |
| 88 | 5. **无报告不终止**: 查询质量报告时如返回"探查报告不存在",统一按"暂无质量报告"理解,继续进入"是否配置规则并发起检测"的确认步骤 |
| 89 | 6. **已授权可直走**: 如果用户在当前轮已明确表达"继续处理/解决问题/发起检测",则可直接进入规则配置与质量检测流程 |
| 90 | 7. **ID语义不能混用**: 知识网络对象类中的 `data_source.id` 是统一视图ID(用于 `mdl_id` 查逻辑视图),不是工单 `datasource_id` |
| 91 | 8. **工单数据源来源**: `datasource_id`、`datasource_name`、`datasource_type` 必须来自逻辑视图 |
| 92 | 9. **成功响应兼容**: 创建规则成功状态以 `200/201` 都视为成功;创建工单成功后优先读取 `id`,并兼容 `work_order_id` |
| 93 | 10. **评分展示格式**: 评分直接展示数值,不带 "/100" 后缀,四舍五入到两位小数 |
| 94 | 11. **质量报告null值处理**: 维度评分为null时显示为"未配置",不参与综合评分计算 |
| 95 | 12. **统一检测策略**: 多视图需要检测时,优先为所有视图配置规则,然后统一创建一个质量检测工单 |
| 96 | 13. **业务视角分析**: 质量报告分析必须结合business_desc和business_docs,从业务视角解读质量指标 |
| 97 | |
| 98 | ## 文档结构 |
| 99 | |
| 100 | ``` |
| 101 | data-quality/ |
| 102 | ├── SKILL.md # 本文件 - 主入口 |
| 103 | ├── CHANGELOG.md # 版本历史 |
| 104 | ├── README.md # 文档指南 |
| 105 | │ |
| 106 | ├── core/ # 核心概念层 (L1) |
| 107 | │ └── core.md # 核心概念 |
| 108 | │ |
| 109 | ├── guides/ # 用户指南层 (L2) |
| 110 | │ ├── quickstart.md # 快速开始指南 |
| 111 | │ └── detailed-guide.md # 详细工作流 |
| 112 | │ |
| 113 | ├── reference/ # 参考文档 |
| 114 | │ ├── core-constraints.md # 核心约束(共享引用) |
| 115 | │ ├── glossary.md # 术语表 |
| 116 | │ ├── quality-inspection-workflow.md # 质量检测工作流 |
| 117 | │ ├── knowledge-network-workflow.md # 知识网络工作流 |
| 118 | │ ├── batch-processing-guide.md # 批量配置处理流程 |
| 119 | │ ├── error-handling.md # 错误处理指南 |
| 120 | │ ├── quality-report-scoring.md # 评分处理策略 |
| 121 | │ ├── api-overview.md # API 概览 |
| 122 | │ ├── intent-recognition.md # 意图识别 |
| 123 | │ ├── pagination.md # 分页规范 |
| 124 | │ ├── api-path-validation.md # API 路径验证 |
| 125 | │ ├── api-usage-guide.md # API 使用规范 |
| 126 | │ └── api/ # 详细 API 文档 |
| 127 | │ ├── api_data_view.md |
| 128 | │ ├── api_task_center.md |
| 129 | │ ├── api_knowledge_network.md |
| 130 | │ ├── api_eacp.md |
| 131 | │ └── api_std.md |
| 132 | │ |
| 133 | └── examples/ # 代码示例 |
| 134 | └── basic-usage.md # 基础用法示例 |
| 135 | ``` |
| 136 | |
| 137 | ## 渐进式加载指南 |
| 138 | |
| 139 | ``` |
| 140 | 用户请求分析 |
| 141 | │ |
| 142 | ├─ 简单查询(视图/字段) ──▶ 加载核心 + 快速开始 |
| 143 | │ |
| 144 | ├─ 规则配置 ──▶ 加载快速开始 + API 指南 |
| 145 | │ |
| 146 | ├─ 质量检测 ──▶ 加载详细指南 + 质量检测工作流 |
| 147 | │ |
| 148 | ├─ 知识网络 ──▶ 加载详细指南 + 知识网络工作流 |
| 149 | │ |
| 150 | ├─ 错误处理 ──▶ 加载错误处理指南 |
| 151 | │ |
| 152 | └─ 复杂/错误场景 ──▶ 加载全部 + 示例 |
| 153 | ``` |
| 154 | |
| 155 | ## 快速导航 |
| 156 | |
| 157 | | 文档 | 用途 | |
| 158 | |------|------| |
| 159 | | [核心概念](./core/core.md) | 核心信息和快速参考 | |
| 160 | | [快速开始](./guides/quickstart.md) | 详细示例和常用操作 | |
| 161 | | [详细指南](./guides/detailed-guide.md) | 完整工作流和高级功能 | |
| 162 | | [质量检测工作流](./reference/quality-inspection-workflow.md) | 质量检测完整流程 | |
| 163 | | [知识网络工作流](./reference/knowledge-network-workflow.md) | 知识网络场景处理 | |
| 164 | | [批量配置处理](./reference/batch-processing-guide.md) | 分页加载与串行处理 | |
| 165 | | [核心约束](./reference/core-constraints.md) | 共享约束参考 | |
| 166 | | [错误处理](./reference/error-handling.md) | 完整错误处理指南 | |
| 167 | | [评分处理](./reference/quality-report-scoring.md) | 评分转换与展示 | |
| 168 | | [API 概览](./reference/api-overview.md) | API 参考 | |
| 169 | | [术语表](./reference/glossary.md) | 术语说明 | |
| 170 | | [示例代码](./examples/basic-usage.md) | 代码样例 | |