SuperAPI AI 工具集

fhir-hl7-validator

数据与分析

查看项目

更新于 10-13 14:32

技能介绍

FHIR & HL7 Validator 是一个面向 AI 智能体的医疗数据格式校验技能,主要用于验证医疗健康数据是否符合 HL7 相关标准与实现指南,帮助发现数据结构、语义和互操作性方面的问题。

用途

该技能应在用户提出以下需求时使用:验证 FHIR 资源、检查 HL7 消息、验证医疗健康数据格式、解析 FHIR、校验 HL7 v2 消息,以及验证 CDA 临床文档等。它面向医疗数据交换场景,用于确保数据符合 HL7 标准,并识别模式违规、缺失必填字段和互操作性问题。

主要能力

  • FHIR 验证:依据官方模式验证 FHIR R5 资源。
  • HL7 消息解析:解析并验证 HL7 v2.x 消息,包括 ADT、ORU、OBX、RXO。
  • CDA 文档验证:验证临床文档架构(CDA)R2 文档。
  • 模式合规检查:依据 FHIR 规范与 UK Core 检查资源。
  • 数据类型验证:验证 FHIR 数据类型,如 Identifier、CodeableConcept、Reference 等。
  • 引用解析:验证内部与外部引用。
  • 基数检查:确保必填与可选字段的合规性。
  • 术语验证:检查值集与编码系统,包括 SNOMED CT、LOINC、ICD-10。
  • 互操作性分析:识别实现指南的遵循情况。
  • 错误报告:生成包含修复建议的详细验证错误报告。

使用方式

调用格式为:

/fhir-hl7-validator [command] [target] [options]

命令包括:

  • validate-fhir <file>:验证 FHIR JSON/XML 资源
  • validate-hl7 <file>:验证 HL7 v2 消息
  • validate-cda <file>:验证 CDA 临床文档
  • parse-fhir <file>:解析并显示 FHIR 资源结构
  • parse-hl7 <file>:解析并显示 HL7 段
  • check-references <file>:验证所有资源引用
  • check-terminology <file>:验证编码系统与值集
  • bulk-validate <directory>:批量验证多个文件
  • report <output-format>:生成验证报告(JSON、markdown、HTML)

选项包括:

  • --version <ver>:FHIR 版本(默认 R5;也支持 4.0、3.0)
  • --variant <name>:实现指南(例如 uk-core、us-core)
  • --strict:强制执行 must-support 约束
  • --terminology-check:验证编码系统(启用在线查询)
  • --output <file>:将报告写入文件
  • --format <type>:输出格式:json、markdown、html、xml

工作流程

该技能被调用时按以下流程执行:

  1. 识别医疗数据类型:请用户指定数据格式(FHIR、HL7 v2、CDA)、FHIR 版本或 HL7 方言、实现指南/配置文件(如适用)、数据来源(EHR、实验室系统、影像系统)。
  2. 验证结构:检查 JSON/XML 格式良好性、必填元素是否存在、数据类型一致性、基数合规(最小/最大出现次数)、模式与正则表达式验证。
  3. 语义验证:核实编码系统成员资格(SNOMED CT、LOINC、ICD-10 等)、引用一致性(本地与外部)、标识符唯一性与格式、日期/时间格式准确性(ISO 8601)、数量单位有效性。
  4. 互操作性检查:确保符合 FHIR 实现指南、US Core 或 UK Core 配置文件、HL7 消息规范、临床数据交换标准。
  5. 生成报告:提供带行号的验证错误列表、严重级别(error、warning、info)、修复指导、相关标准引用。

常见验证错误

  • 缺失必填元素:标记为 cardinality: 1..1 的元素不存在;解决方法是添加该必填元素。
  • 无效数据类型:值与指定类型不匹配;解决方法是转换为正确类型(例如日期转换为 YYYY-MM-DD)。
  • 未知编码系统:代码不在指定值集中;解决方法是使用官方编码系统中的代码(SNOMED CT、LOINC)。
  • 引用损坏:引用目标不存在;解决方法是核实引用路径与 ID。
  • 无效标识符格式:ID 格式与模式不匹配;解决方法是遵循系统特定的标识符格式。

适用场景

适用于需要验证 FHIR R5 资源、解析和检查 HL7 v2.x 消息(如 ADT、ORU、OBX、RXO)、验证 CDA R2 临床文档,以及检查编码系统、值集、引用一致性和实现指南合规性的医疗数据交换场景。数据来源可能包括 EHR、实验室系统、影像系统等。

限制

资料中未提供该技能的具体运行环境、依赖条件、安装方式、收费或价格信息、平台支持范围、性能表现或效果数据,这些内容暂未提供。