FHIR Developer Skill

• FHIRのRESTエンドポイント（Patient、Observation、Encounter、Condition、MedicationRequest）を構築しており、仕様に準拠したフィールド要件とバリューセットが必要な場合。
• FHIRサーバーに適切なHTTPステータスコードとOperationOutcomeエラーレスポンスを実装する必要がある場合。
• SMART on FHIR OAuthの認可を統合しており、正しいスコープ構文と適用パターンが必要な場合。
• FHIRバンドル（transaction、batch、searchset）を扱っているか、検索のページネーションを実装している場合。

• あなたがFHIR DSTU2またはSTU3を使用している場合 — このスキルは特にR4を対象としています。
• ライブFHIRサーバーやデータストレージソリューションが必要な場合；このスキルは開発ガイダンスのみを提供し、インフラストラクチャは提供しません。
• あなたのプロジェクトにヘルスケアデータやFHIR APIの要件がない場合。

Patient、Observation、Encounter、Condition、MedicationRequest、Medication、Bundle に関する必須フィールドのカーディナリティ表を権威ある情報として提供し、任意フィールドを必須として扱うような一般的な誤りを防ぎます。

すべての主要なバリューセット（Observation.status、Encounter.status/class、Condition.clinicalStatus、MedicationRequest.status/intent、Bundle.type、Patient.gender）を対象とし、無効な列挙値に対して正しい 422 レスポンスを返します。

200、201、204、400、401、403、404、412、422をいつ使用するかについての的確なガイダンス — ETAGの不一致に対する412 Precondition Failedと、バリデーションエラーに対する422の重要な使い分けを含みます。

Python/FastAPIおよびTypeScript/Express向けのすぐに使えるOperationOutcome JSON構造とコードスニペットを提供し、すべてのエラーレスポンスがFHIR準拠であることを保証します。

LOINC、SNOMED CT、RxNorm、ICD-10、およびHL7ターミノロジーシステムの正規システムURL、ならびにすぐに参照できるバイタルサインの一般的なLOINCコードをまとめています。

OAuthスコープの適用、条件付き作成・更新操作、トランザクションとバッチのBundleセマンティクスの違い、および検索結果のページネーションパターンに関するリファレンス情報です。

アシスタントに、FastAPIまたはExpressで正しいステータスバリデーション、422エラーレスポンス、およびOperationOutcomeフォーマットを備えたPOST /Observationエンドポイントのスキャフォールドを作成するよう依頼してください。

既存のFHIRエンドポイントのコードを貼り付けて、アシスタントに違反箇所を特定するよう依頼しましょう — 例えば、誤ったステータスコード、Locationヘッダーの欠如、またはEncounter.classの不正なデータ型などです。

OAuth スコープ構文（v1/v2）、バックエンドサービスフロー、および FHIR エンドポイントを保護するためのスコープ適用ロジックに関するガイダンスを提供します。

組み込みのクイックスタートスクリプトリファレンスを使用して、正しいPydantic v2モデル、OperationOutcomeヘルパー、およびPatient CRUDエンドポイントを備えたFastAPIプロジェクトを生成します。