核心功能
该技能专注于将临床需求文档转换为符合FHIR R4标准的Questionnaire资源,解决医疗信息化中最关键的编码标准化问题。
核心用法:
1. 编码查询:通过 search_loinc.py 和 search_snomed.py 脚本实时查询官方术语服务器,获取临床问题、观察指标、疾病诊断的标准化代码
2. 答案值集查询:query_valueset.py 自动获取LOINC配套的标准答案列表(如PHQ-9抑郁量表的应答选项)
3. 问卷构建:基于模板(minimal/basic/advanced)快速搭建问卷结构,支持条件显示、重复组、标准/自定义答案列表等复杂逻辑
4. 验证输出:validate_questionnaire.py 确保最终JSON符合FHIR规范
显著优点:
- 编码权威性:强制通过API查询LOINC/SNOMED CT,杜绝AI"幻觉"生成虚假代码,这是临床系统互操作的生命线
- 零配置成本:无需申请API密钥,直接访问NIH clinicaltables和tx.fhir.org公共端点
- 临床场景全覆盖:从标准化量表(PHQ-9、GAD-7)到自定义机构问卷均有成熟工作流
- 渐进式复杂度:inline answerOption(无系统)满足简单需求,可选Welshare命名空间支持跨问卷复用
潜在局限与风险:
- 网络依赖性强:必须白名单访问clinicaltables.nlm.nih.gov和tx.fhir.org,离线环境完全失效
- 术语服务器稳定性:公共FHIR术语服务器偶有超时,需配置备用端点(HAPI、CSIRO Ontoserver)
- SNOMED CT语义标签限制:--semantic-tag过滤依赖服务器返回的显示名称,非标准化字段
- 编码查询延迟:实时API调用可能拖慢交互速度,高频场景需考虑本地缓存
适合人群:
医疗信息化工程师、FHIR实施顾问、临床研究人员、EHR系统产品经理。特别适合需要快速将纸质量表/临床评估表数字化的团队,以及对互操作性标准有合规要求的医疗机构。
常规风险提醒:
- 严禁依赖训练数据中的LOINC/SNOMED代码,必须通过脚本实时验证
- 自定义编码系统URI为可选高级功能,默认应使用无系统的inline answerOption
- 生产环境建议部署企业级FHIR术语服务器替代公共端点