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
工作流程
该技能被调用时按以下流程执行:
- 识别医疗数据类型:请用户指定数据格式(FHIR、HL7 v2、CDA)、FHIR 版本或 HL7 方言、实现指南/配置文件(如适用)、数据来源(EHR、实验室系统、影像系统)。
- 验证结构:检查 JSON/XML 格式良好性、必填元素是否存在、数据类型一致性、基数合规(最小/最大出现次数)、模式与正则表达式验证。
- 语义验证:核实编码系统成员资格(SNOMED CT、LOINC、ICD-10 等)、引用一致性(本地与外部)、标识符唯一性与格式、日期/时间格式准确性(ISO 8601)、数量单位有效性。
- 互操作性检查:确保符合 FHIR 实现指南、US Core 或 UK Core 配置文件、HL7 消息规范、临床数据交换标准。
- 生成报告:提供带行号的验证错误列表、严重级别(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、实验室系统、影像系统等。
限制
资料中未提供该技能的具体运行环境、依赖条件、安装方式、收费或价格信息、平台支持范围、性能表现或效果数据,这些内容暂未提供。