fhir-developer-skill

此技能作為工程師與開發人員構建符合 HL7 FHIR R4 標準的醫療保健數據交換解決方案的權威參考。它提供後端開發所需的關鍵架構模式，包括模式驗證、RESTful 端點設計與強制狀態碼管理。該工具旨在彌合抽象健康數據標準與具體程式碼實現之間的差距，對於從事電子健康紀錄 (EHR) 整合、病人門戶或臨床數據互操作性項目的團隊至關重要。

• 完整的 FHIR R4 資源結構指南，包含 Patient、Observation、Encounter、Condition 與 MedicationRequest 的配置。

• 針對必填與選填欄位的嚴格驗證邏輯，確保基數 (cardinality) 合規以防止常見整合錯誤。

• 值集的綜合查詢表，包括性別代碼、就診類別與臨床狀態列舉。

• OperationOutcome 錯誤響應與 HTTP 狀態碼 (200, 201, 401, 403, 422 等) 的標準化實現模式。

• 國際編碼系統與術語標準參考，包括 LOINC、SNOMED CT、RxNorm 與 ICD-10。

• 生命徵象預定義編碼模板，包括血壓與心率測量定義。

• 安全訪問健康數據的 SMART on FHIR 授權流程與 OAuth 範圍要求指南。

• 處理 Bundle、事務、批量操作與搜尋分頁的輔助模式。

• 在開發 REST API 時，使用此技能根據 FHIR R4 規範驗證 JSON 負載。

• 參考提供的 HTTP 狀態碼指引，確保 API 符合 RESTful 醫療保健實踐並準確溝通驗證失敗情況。

• 利用提供的 Pydantic v2 與 TypeScript/Express 程式碼片段，快速搭建安全且合規的服務架構。

• 在實現資源創建時，嚴格遵循提供的基數規則，以識別必填欄位與可選屬性。

• 整合建議的 OperationOutcome 結構，提供開發人員與自動化系統可正確解讀的意義明確的錯誤日誌。

• 務必參考編碼系統的標準 URL，以在不同醫療軟件平台之間保持互操作性。