{"id":"88d84989-55bf-4892-9ecf-0c9329e29398","shortId":"j4mACU","kind":"skill","title":"data-quality","tagline":"基于 Data View 和 Task Center API 的数据质量管理。管理质量规则、查询逻辑视图、创建检测工单。当用户需要数据质量相关操作时使用。","description":"# 数据质量管理\n\n> **渐进式加载**: [核心概念](./core/core.md) → [快速开始](./guides/quickstart.md) → [详细指南](./guides/detailed-guide.md)\n\n## 核心能力\n\n| 能力 | 说明 | API 端点 |\n|------|------|----------|\n| 质量规则 | 质量规则的增删改查 | `/api/data-view/v1/explore-rule` |\n| 逻辑视图 | 查询视图列表和字段信息 | `/api/data-view/v1/form-view` |\n| 检测工单 | 创建和跟踪检测工单 | `/api/task-center/v1/work-order` |\n| 知识网络 | 基于知识网络配置规则 | `/api/ontology-manager/v1` |\n\n## 技能入参\n\n技能接受以下入参，大模型在调用技能时应按以下格式传递：\n\n```json\n{\n  \"query\": \"用户提问内容（必须）\",\n  \"business_docs\": [\"业务知识文档列表（可选）\"],\n  \"business_desc\": \"业务知识描述文本（可选）\",\n  \"context\": \"其它可用上下文文本（可选）\"\n}\n```\n\n### 入参说明\n\n| 参数名 | 类型 | 必填 | 说明 |\n|--------|------|------|------|\n| `query` | string | **是** | 用户提问内容，描述用户想要执行的数据质量管理操作 |\n| `business_docs` | array | 否 | 业务知识文档列表，用户提供配置质量规则时的业务知识文档 |\n| `business_desc` | string | 否 | 业务知识描述文本，用户提供配置质量规则时的业务知识文本描述 |\n| `context` | string | 否 | 其它可用上下文文本，用户提供必要的上下文依据 |\n\n### 入参使用场景总览\n\n| 场景 | query | context | business_desc | business_docs |\n|------|-------|---------|---------------|---------------|\n| 知识网络质量分析 | ✅ | ✅ | ✅ | ✅ |\n| 视图质量查询 | ✅ | ✅ | ✅ | ✅ |\n| 规则配置 | ✅ | ✅ | ✅ | ✅ |\n| 质量检测 | ✅ | ✅ | - | - |\n| 问题诊断 | ✅ | ✅ | - | - |\n\n### 入参职责区分\n\n**重要**: 各入参有明确的职责分工，不得混用：\n\n| 入参 | 职责 | 说明 |\n|------|------|------|\n| `query` | **目标识别（第一优先级）** | 用于确定要分析的知识网络或对象类 |\n| `context` | **目标识别（第二优先级）** | 当query中没有明确目标时，从context中提取知识网络或对象类信息 |\n| `business_desc` | **规则配置依据** | 仅作为配置质量规则时的业务语义来源 |\n| `business_docs` | **规则配置依据** | 仅作为配置质量规则时的业务文档来源 |\n\n**目标识别优先级**:\n```\n1. 首先从 query 中提取知识网络/对象类信息\n2. 如果 query 中没有明确目标，才从 context 中提取\n3. business_desc 和 business_docs 永远不能用于确定分析目标\n```\n\n### 使用优先级\n\n1. **query** 始终必须，用于确定用户意图和分析目标\n2. **context** 用于提供必要的上下文依据，当query无目标时作为分析目标的补充来源\n3. **business_desc** 仅用于配置质量规则时提供业务语义\n4. **business_docs** 仅用于配置质量规则时提供业务文档\n\n## 前置条件\n\n```bash\nDATA_QUALITY_BASE_URL=https://10.4.134.26\nDATA_QUALITY_AUTH_TOKEN=Bearer xxxxxx\n```\n\n**验证**: `GET {BASE_URL}/api/eacp/v1/user/get`\n\n## 关键约束\n\n> **详细约束请参考**: [核心约束参考](./reference/core-constraints.md)\n\n1. **配置优先**: 使用前必须先验证环境变量\n2. **有据可依**: 规则配置必须有明确的依据\n3. **配置非空**: 创建规则时 `rule_config` 不能为空\n4. **技术名称**: `rule_config` 中的 SQL 表达式必须使用字段技术名称\n5. **无报告不终止**: 查询质量报告时如返回\"探查报告不存在\"，统一按\"暂无质量报告\"理解，继续进入\"是否配置规则并发起检测\"的确认步骤\n6. **已授权可直走**: 如果用户在当前轮已明确表达\"继续处理/解决问题/发起检测\"，则可直接进入规则配置与质量检测流程\n7. **ID语义不能混用**: 知识网络对象类中的 `data_source.id` 是统一视图ID（用于 `mdl_id` 查逻辑视图），不是工单 `datasource_id`\n8. **工单数据源来源**: `datasource_id`、`datasource_name`、`datasource_type` 必须来自逻辑视图\n9. **成功响应兼容**: 创建规则成功状态以 `200/201` 都视为成功；创建工单成功后优先读取 `id`，并兼容 `work_order_id`\n10. **评分展示格式**: 评分直接展示数值，不带 \"/100\" 后缀，四舍五入到两位小数\n11. **质量报告null值处理**: 维度评分为null时显示为\"未配置\"，不参与综合评分计算\n12. **统一检测策略**: 多视图需要检测时，优先为所有视图配置规则，然后统一创建一个质量检测工单\n13. **业务视角分析**: 质量报告分析必须结合business_desc和business_docs，从业务视角解读质量指标\n\n## 文档结构\n\n```\ndata-quality/\n├── SKILL.md                    # 本文件 - 主入口\n├── CHANGELOG.md                # 版本历史\n├── README.md                   # 文档指南\n│\n├── core/                       # 核心概念层 (L1)\n│   └── core.md                 # 核心概念\n│\n├── guides/                     # 用户指南层 (L2)\n│   ├── quickstart.md           # 快速开始指南\n│   └── detailed-guide.md       # 详细工作流\n│\n├── reference/                  # 参考文档\n│   ├── core-constraints.md     # 核心约束（共享引用）\n│   ├── glossary.md             # 术语表\n│   ├── quality-inspection-workflow.md  # 质量检测工作流\n│   ├── knowledge-network-workflow.md   # 知识网络工作流\n│   ├── batch-processing-guide.md       # 批量配置处理流程\n│   ├── error-handling.md       # 错误处理指南\n│   ├── quality-report-scoring.md      # 评分处理策略\n│   ├── api-overview.md         # API 概览\n│   ├── intent-recognition.md   # 意图识别\n│   ├── pagination.md          # 分页规范\n│   ├── api-path-validation.md  # API 路径验证\n│   ├── api-usage-guide.md      # API 使用规范\n│   └── api/                    # 详细 API 文档\n│       ├── api_data_view.md\n│       ├── api_task_center.md\n│       ├── api_knowledge_network.md\n│       ├── api_eacp.md\n│       └── api_std.md\n│\n└── examples/                   # 代码示例\n    └── basic-usage.md          # 基础用法示例\n```\n\n## 渐进式加载指南\n\n```\n用户请求分析\n    │\n    ├─ 简单查询（视图/字段） ──▶ 加载核心 + 快速开始\n    │\n    ├─ 规则配置 ──▶ 加载快速开始 + API 指南\n    │\n    ├─ 质量检测 ──▶ 加载详细指南 + 质量检测工作流\n    │\n    ├─ 知识网络 ──▶ 加载详细指南 + 知识网络工作流\n    │\n    ├─ 错误处理 ──▶ 加载错误处理指南\n    │\n    └─ 复杂/错误场景 ──▶ 加载全部 + 示例\n```\n\n## 快速导航\n\n| 文档 | 用途 |\n|------|------|\n| [核心概念](./core/core.md) | 核心信息和快速参考 |\n| [快速开始](./guides/quickstart.md) | 详细示例和常用操作 |\n| [详细指南](./guides/detailed-guide.md) | 完整工作流和高级功能 |\n| [质量检测工作流](./reference/quality-inspection-workflow.md) | 质量检测完整流程 |\n| [知识网络工作流](./reference/knowledge-network-workflow.md) | 知识网络场景处理 |\n| [批量配置处理](./reference/batch-processing-guide.md) | 分页加载与串行处理 |\n| [核心约束](./reference/core-constraints.md) | 共享约束参考 |\n| [错误处理](./reference/error-handling.md) | 完整错误处理指南 |\n| [评分处理](./reference/quality-report-scoring.md) | 评分转换与展示 |\n| [API 概览](./reference/api-overview.md) | API 参考 |\n| [术语表](./reference/glossary.md) | 术语说明 |\n| [示例代码](./examples/basic-usage.md) | 代码样例 |","tags":["data","quality","kweaver","dip","kweaver-ai","agent-skills","agents","digital-worker","ontology","openclaw"],"capabilities":["skill","source-kweaver-ai","skill-data-quality","topic-agent-skills","topic-agents","topic-digital-worker","topic-ontology","topic-openclaw"],"categories":["kweaver-dip"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/kweaver-ai/kweaver-dip/data-quality","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add kweaver-ai/kweaver-dip","source_repo":"https://github.com/kweaver-ai/kweaver-dip","install_from":"skills.sh"}},"qualityScore":"0.508","qualityRationale":"deterministic score 0.51 from registry signals: · indexed on github topic:agent-skills · 117 github stars · SKILL.md body (4,832 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-02T06:55:19.995Z","embedding":null,"createdAt":"2026-04-18T22:14:45.158Z","updatedAt":"2026-05-02T06:55:19.995Z","lastSeenAt":"2026-05-02T06:55:19.995Z","tsv":"'/100':254 '/api/data-view/v1/explore-rule':31 '/api/data-view/v1/form-view':34 '/api/eacp/v1/user/get':177 '/api/ontology-manager/v1':40 '/api/task-center/v1/work-order':37 '/core/core.md':19,366 '/examples/basic-usage.md':401 '/guides/detailed-guide.md':23,372 '/guides/quickstart.md':21,369 '/reference/api-overview.md':394 '/reference/batch-processing-guide.md':381 '/reference/core-constraints.md':181,384 '/reference/error-handling.md':387 '/reference/glossary.md':398 '/reference/knowledge-network-workflow.md':378 '/reference/quality-inspection-workflow.md':375 '/reference/quality-report-scoring.md':390 '1':124,144,182 '10':250 '10.4.134.26':166 '11':257 '12':262 '13':267 '2':129,148,185 '200/201':242 '3':136,152,188 '4':156,194 '5':201 '6':211 '7':218 '8':230 '9':239 'api':10,27,314,321,324,326,328,348,392,395 'api-overview.md':313 'api-path-validation.md':320 'api-usage-guide.md':323 'api_data_view.md':330 'api_eacp.md':333 'api_knowledge_network.md':332 'api_std.md':334 'api_task_center.md':331 'array':71 'auth':169 'base':164,175 'bash':161 'basic-usage.md':337 'batch-processing-guide.md':307 'bearer':171 'busi':48,52,69,75,90,92,115,119,137,140,153,157 'center':9 'changelog.md':280 'config':192,197 'context':56,81,89,110,134,149 'core':284 'core-constraints.md':298 'core.md':287 'data':2,5,162,167,275 'data-qu':1,274 'data_source.id':221 'datasourc':228,232,234,236 'desc':53,76,91,116,138,154 'desc和busi':270 'detailed-guide.md':294 'doc':49,70,93,120,141,158,271 'error-handling.md':309 'exampl':335 'get':174 'glossary.md':301 'guid':289 'id':225,229,233,245,249 'id语义不能混用':219 'intent-recognition.md':316 'json':44 'knowledge-network-workflow.md':305 'l1':286 'l2':291 'mdl':224 'name':235 'order':248 'pagination.md':318 'qualiti':3,163,168,276 'quality-inspection-workflow.md':303 'quality-report-scoring.md':311 'queri':45,64,88,106,126,131,145 'quickstart.md':292 'readme.md':282 'refer':296 'rule':191,196 'skill' 'skill-data-quality' 'skill.md':277 'source-kweaver-ai' 'sql':199 'string':65,77,82 'task':8 'token':170 'topic-agent-skills' 'topic-agents' 'topic-digital-worker' 'topic-ontology' 'topic-openclaw' 'type':237 'url':165,176 'view':6 'work':247 'xxxxxx':172 '不参与综合评分计算':261 '不带':253 '不得混用':102 '不是工单':227 '不能为空':193 '业务知识描述文本':54,79 '业务知识文档列表':50,73 '业务视角分析':268 '中提取':135 '中提取知识网络':127 '中没有明确目标':132 '中的':198 '主入口':279 '仅作为配置质量规则时的业务文档来源':122 '仅作为配置质量规则时的业务语义来源':118 '仅用于配置质量规则时提供业务文档':159 '仅用于配置质量规则时提供业务语义':155 '从context中提取知识网络或对象类信息':114 '从业务视角解读质量指标':272 '代码样例':402 '代码示例':336 '优先为所有视图配置规则':265 '使用优先级':143 '使用前必须先验证环境变量':184 '使用规范':325 '入参':103 '入参使用场景总览':86 '入参职责区分':99 '入参说明':59 '共享引用':300 '共享约束参考':385 '关键约束':178 '其它可用上下文文本':57,84 '分页加载与串行处理':382 '分页规范':319 '则可直接进入规则配置与质量检测流程':217 '创建和跟踪检测工单':36 '创建工单成功后优先读取':244 '创建检测工单':14 '创建规则成功状态以':241 '创建规则时':190 '前置条件':160 '加载全部':360 '加载快速开始':347 '加载核心':344 '加载详细指南':351,354 '加载错误处理指南':357 '参数名':60 '参考':396 '参考文档':297 '发起检测':216 '可选':51,55,58 '各入参有明确的职责分工':101 '后缀':255 '否':72,78,83 '和':7,139 '四舍五入到两位小数':256 '场景':87 '基于':4 '基于知识网络配置规则':39 '基础用法示例':338 '复杂':358 '多视图需要检测时':264 '大模型在调用技能时应按以下格式传递':43 '如果':130 '如果用户在当前轮已明确表达':213 '始终必须':146 '字段':343 '完整工作流和高级功能':373 '完整错误处理指南':388 '对象类信息':128 '工单数据源来源':231 '已授权可直走':212 '并兼容':246 '当query中没有明确目标时':113 '当query无目标时作为分析目标的补充来源':151 '当用户需要数据质量相关操作时使用':15 '必填':62 '必须':47 '必须来自逻辑视图':238 '快速导航':362 '快速开始':20,345,368 '快速开始指南':293 '意图识别':317 '成功响应兼容':240 '才从':133 '批量配置处理':380 '批量配置处理流程':308 '技术名称':195 '技能入参':41 '技能接受以下入参':42 '指南':349 '探查报告不存在':204 '描述用户想要执行的数据质量管理操作':68 '数据质量管理':16 '文档':329,363 '文档指南':283 '文档结构':273 '无报告不终止':202 '是':66 '是否配置规则并发起检测':209 '是统一视图id':222 '暂无质量报告':206 '有据可依':186 '未配置':260 '本文件':278 '术语表':302,397 '术语说明':399 '查询视图列表和字段信息':33 '查询质量报告时如返回':203 '查询逻辑视图':13 '查逻辑视图':226 '核心信息和快速参考':367 '核心概念':18,288,365 '核心概念层':285 '核心约束':299,383 '核心约束参考':180 '核心能力':24 '检测工单':35 '概览':315,393 '永远不能用于确定分析目标':142 '渐进式加载':17 '渐进式加载指南':339 '然后统一创建一个质量检测工单':266 '版本历史':281 '理解':207 '用于':223 '用于提供必要的上下文依据':150 '用于确定用户意图和分析目标':147 '用于确定要分析的知识网络或对象类':109 '用户指南层':290 '用户提供必要的上下文依据':85 '用户提供配置质量规则时的业务知识文本描述':80 '用户提供配置质量规则时的业务知识文档':74 '用户提问内容':46,67 '用户请求分析':340 '用途':364 '的数据质量管理':11 '的确认步骤':210 '目标识别':107,111 '目标识别优先级':123 '知识网络':38,353 '知识网络场景处理':379 '知识网络对象类中的':220 '知识网络工作流':306,355,377 '知识网络质量分析':94 '示例':361 '示例代码':400 '端点':28 '第一优先级':108 '第二优先级':112 '简单查询':341 '管理质量规则':12 '类型':61 '统一按':205 '统一检测策略':263 '继续处理':214 '继续进入':208 '维度评分为null时显示为':259 '职责':104 '能力':25 '表达式必须使用字段技术名称':200 '规则配置':96,346 '规则配置依据':117,121 '规则配置必须有明确的依据':187 '视图':342 '视图质量查询':95 '解决问题':215 '评分处理':389 '评分处理策略':312 '评分展示格式':251 '评分直接展示数值':252 '评分转换与展示':391 '详细':327 '详细工作流':295 '详细指南':22,371 '详细示例和常用操作':370 '详细约束请参考':179 '说明':26,63,105 '质量报告null值处理':258 '质量报告分析必须结合busi':269 '质量检测':97,350 '质量检测完整流程':376 '质量检测工作流':304,352,374 '质量规则':29 '质量规则的增删改查':30 '路径验证':322 '逻辑视图':32 '都视为成功':243 '配置优先':183 '配置非空':189 '重要':100 '错误场景':359 '错误处理':356,386 '错误处理指南':310 '问题诊断':98 '首先从':125 '验证':173","prices":[{"id":"dc42e707-6d7c-4bfd-9bca-cd0d47934034","listingId":"88d84989-55bf-4892-9ecf-0c9329e29398","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"kweaver-ai","category":"kweaver-dip","install_from":"skills.sh"},"createdAt":"2026-04-18T22:14:45.158Z"}],"sources":[{"listingId":"88d84989-55bf-4892-9ecf-0c9329e29398","source":"github","sourceId":"kweaver-ai/kweaver-dip/data-quality","sourceUrl":"https://github.com/kweaver-ai/kweaver-dip/tree/main/skills/data-quality","isPrimary":false,"firstSeenAt":"2026-04-18T22:14:45.158Z","lastSeenAt":"2026-05-02T06:55:19.995Z"}],"details":{"listingId":"88d84989-55bf-4892-9ecf-0c9329e29398","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"kweaver-ai","slug":"data-quality","github":{"repo":"kweaver-ai/kweaver-dip","stars":117,"topics":["agent-skills","agents","ai","business-knowledge-network","digital-worker","ontology","openclaw"],"license":"apache-2.0","html_url":"https://github.com/kweaver-ai/kweaver-dip","pushed_at":"2026-05-01T05:38:33Z","description":"KWeaver DIP is an enterprise-level digital employee platform, built on KWeaver Core. It provides an AI-native environment for developing and managing digital employees on business knowledge networks—for enterprise intelligence that is understandable, executable, and governable.","skill_md_sha":"eecc8f41d81b813eb5dda3cc01adcbb6353df785","skill_md_path":"skills/data-quality/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/kweaver-ai/kweaver-dip/tree/main/skills/data-quality"},"layout":"multi","source":"github","category":"kweaver-dip","frontmatter":{"name":"data-quality","description":"基于 Data View 和 Task Center API 的数据质量管理。管理质量规则、查询逻辑视图、创建检测工单。当用户需要数据质量相关操作时使用。"},"skills_sh_url":"https://skills.sh/kweaver-ai/kweaver-dip/data-quality"},"updatedAt":"2026-05-02T06:55:19.995Z"}}