开发与工程 ✓ Anthropic · 官方

FHIR API 开发指南

帮助开发者构建、验证并保护符合 FHIR R4 的医疗 API。

41/ 100
不推荐

当前收益不足以覆盖风险或不确定性。

查看评分依据 ↓
可直接使用于
Codex · Claude Code
Star 数
★ 425
最近更新
1 个月前
fhirhealthcare-apifastapioauth
+3smart-on-fhirrest-apipydantic

这个 Skill 能做什么,适合哪些场景?

该技能面向需要开发医疗接口的软件工程师,覆盖 FHIR R4 资源结构、REST 端点、验证规则和错误响应。它提供 Patient、Observation、Encounter、Condition、MedicationRequest、Medication 与 Bundle 的字段要求和值集参考。内容还涉及 SMART on FHIR 授权、OAuth 作用域、事务与批处理、搜索分页及条件操作。适合希望在 FastAPI 或 TypeScript/Express 中实现 FHIR API 的团队,但源材料未提供测试结果或完整运行环境说明。

指导创建 FHIR REST 端点,检查资源必填字段、枚举值和编码系统,并用 OperationOutcome 返回错误。它说明如何处理 HTTP 状态码、Content-Type、Location、ETag、If-Match、If-None-Exist、Bundle 事务和搜索分页。示例覆盖 Python/FastAPI、Pydantic v2 以及 TypeScript/Express,并提供一个可运行的脚手架命令:python scripts/setup_fhir_project.py my_fhir_api。

适合
  • 医疗软件工程师在实现 Patient、Observation 或 Encounter CRUD 接口时,需要确认字段要求和 HTTP 响应。
  • FHIR 服务开发团队在处理非法状态值、缺少字段或业务规则冲突时,需要统一返回 422 和 OperationOutcome。
  • 需要支持 SMART on FHIR 的团队在设计 OAuth 作用域和授权流程时,可将其作为开发参考。
  • 实现医院 FHIR R4 搜索服务的开发者需要处理 Bundle、分页、事务或批量操作。
  • 使用 FastAPI 或 TypeScript/Express 构建原型的开发者需要参考资源模型和错误处理模式。

如何安装这个 Skill?

使用前请注意
  • 不要将该技能或生成的脚手架直接用于生产医疗数据系统;上线前应补充正式 FHIR 规范核验、全面测试、权限最小化、密钥管理、审计、并发控制、持久化和恢复方案。
  • 脚手架使用 write_text 写入目标目录,可能覆盖同名文件;使用前应确认目标目录为空或已备份。
  • 依赖版本未锁定,SMART 示例涉及私钥和令牌但未提供安全存储与轮换指导。
  • 示例中的资源覆盖范围和实现能力明显小于技能描述,分页、Bundle、SMART 授权及多数资源仍需自行实现和验证。
开始前你需要
Agent 需要具备
  • Shell / 命令行
  • 本地文件系统
需要预先安装
  • Python
  • FastAPI
  • Pydantic v2

该技能属于 anthropics/healthcare 集合。按 README 执行:/plugin marketplace add anthropics/healthcare,然后执行 /plugin install healthcare@healthcare。源材料未说明如何单独安装 fhir-developer 技能。

通用方式:手动安装到 Claude Code(macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/anthropics/healthcare.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/plugins/healthcare/skills/fhir-developer" ~/.claude/skills/
rm -rf "$tmp"

根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。

如何使用这个 Skill?

试试这样说

安装后,把下面任意一句发给 Agent 即可触发:

  • 请为 Observation 创建 FHIR R4 POST 端点,验证 status,使用 OperationOutcome 返回 422 错误,并设置 application/fhir+json。

在已安装 healthcare 集合的环境中,提出具体 FHIR API 开发任务,例如:“请为 Observation 创建 FHIR R4 POST 端点,验证 status,使用 OperationOutcome 返回 422 错误,并设置 application/fhir+json。”源材料未规定单独的调用命令或参数格式。

这个 Skill 有哪些优点和局限?

优点
  • 覆盖常见 FHIR R4 资源、值集、编码系统和 REST 操作。
  • 明确区分 400、401、403、404、412 和 422 等状态码。
  • 同时提供 FastAPI、Pydantic v2 和 TypeScript/Express 示例。
  • 包含 SMART on FHIR、Bundle、分页和条件操作等实际开发主题。
局限
  • 源材料没有提供测试套件、兼容性矩阵或实际服务器验证证据。
  • 完整资源 JSON、SMART 授权、分页和 Bundle 细节依赖未展示的 references 文件。
  • 它是开发指南和脚手架说明,不是完整的 FHIR 服务器实现。
  • README 只说明集合按 Anthropic 条款提供,未给出独立技能的许可证。

这个 Skill 与同类方案有什么区别?

与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。

Skill FS 评分 Star 数 最近更新 License
FHIR API 开发指南 本页 ✓ Anthropic · 官方 41 · 不推荐 ★ 425 1 个月前 —
FastAPI 路由构建助手 ✓ Microsoft · 官方 51 · 谨慎使用 ★ 2.7k 3 个月前 MIT
Pydantic 多模型架构 ✓ Microsoft · 官方 52 · 谨慎使用 ★ 2.7k 3 个月前 MIT
Azure Cosmos DB Python 服务构建助手 ✓ Microsoft · 官方 47 · 谨慎使用 ★ 2.7k 3 个月前 MIT
FreeHire 技术职位搜索技能 63 · 推荐 ★ 47k 17 天前 MIT

FollowSkills 如何评估这个 Skill?

FollowSkills 评估 · FSRS-2.0
不推荐
41/ 100 五分制 2.1 / 5
上游仓库在本次评估后已有新提交;当前评分仍对应所示审查版本,可能尚未覆盖最新改动。
1信任安全11 / 25 · 2.2/5

内容覆盖 SMART on FHIR、OAuth scope、OperationOutcome 和 ETag 等安全相关主题,且示例体现了权限检查;但未说明患者健康数据的数据流、最小权限原则、用户确认、密钥安全存储、审计、回滚或生产部署隔离。脚本会在指定目录创建并写入多个文件,未提供覆盖风险提示或确认机制,因此扣分。

2可靠稳定6 / 20 · 1.5/5

文档结构清晰,包含多种资源、错误响应和一个基础测试脚本;但静态材料未证明关键路径可运行。示例脚本生成的应用只实现 Patient CRUD,未覆盖文档声称的 Observation、Bundle、分页或 SMART 授权;依赖未锁定,异常输入、并发、持久化和失败诊断也较薄弱,因此按静态上限保守扣分。

3适用触发8 / 15 · 2.7/5

目标用户和场景较明确,涵盖 FHIR R4 API、验证、授权、Bundle 和分页,并给出 Python/FastAPI 与 TypeScript/Express 片段;但未明确非适用范围、版本兼容边界、部署前提或触发条件的排除项,也没有中文说明或中国大陆网络环境适配证据,因此扣分。

4规范维护6 / 15 · 2.0/5

包含快速参考、分主题引用文件、示例、清单和脚手架,信息组织与渐进披露尚可;但技能自身没有清晰的安装说明、依赖版本策略、变更记录、维护责任、更新路径或完整限制说明。许可证元数据未知,README 的仓库级条款不能充分替代技能级治理信息,因此扣分。

5有效结果6 / 15 · 2.0/5

对于设计基础 FHIR R4 端点、资源校验和错误格式,文档提供了可直接参考的代码与 JSON;但脚手架只生成有限的 Patient API,若干声明功能仍需大量自行实现,且没有验证代表性输出或说明与成熟 FHIR 库、服务器实现相比的收益,因此按静态上限评为中等并扣分。

6证据核验4 / 10 · 2.0/5

材料包含源代码、示例测试和明确的 JSON/HTTP 结构,具备一定审计性;但测试仅覆盖基础 Patient 操作,没有 CI、第三方标准引用、完整关键路径覆盖或独立复现结果,且部分规范性断言无法仅由所给文件交叉验证,因此扣分。

1 2 3 4 5 6

点击维度查看打分理由

评估于 2026年7月23日 审查版本 744278a1fe63 评估证据[1][2][3][4][5][6][7][8][9][10]

证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。

查看完整评分方法 →

常见问题

它能直接连接医院的 FHIR 服务器吗?
源材料只说明如何开发 FHIR API,并未显示该技能会直接连接或调用医院服务器。
使用它需要哪些运行依赖?
示例涉及 Python、FastAPI、Pydantic v2 和 TypeScript/Express;脚手架命令使用 Python。源材料未规定具体版本,也未证明所有依赖会自动安装。
验证失败时应返回什么?
缺少必填字段、非法枚举值或业务规则冲突应返回 422 Unprocessable Entity,并使用 OperationOutcome;If-Match 不匹配应返回 412。
它是否需要 MCP 或额外网络权限?
该 SKILL.md 未要求 MCP 或网络调用。README 列出集合中的 FHIR 服务器,但不能据此归属于本技能。

同仓库的其他 Skills

均来自 anthropics/healthcare

数据与分析 ✓ Anthropic · 官方

FHIR 临床数据连接器

连接医院 FHIR R4 服务,提取患者临床数据与病历笔记中的结构化发现。

★ 425 FS 49 谨慎使用 1 个月前
数据与分析 ✓ Anthropic · 官方

临床笔记结构化提取

把临床笔记转成可核验、带原文依据的结构化记录。

★ 425 FS 56 谨慎使用 1 个月前
数据与分析 ✓ Anthropic · 官方

医疗理赔欺诈筛查

将 Medicare/Medicaid 理赔数据转化为有据可查、按优先级排序的调查线索。

★ 425 FS 48 谨慎使用 1 个月前
自动化与运维 ✓ Anthropic · 官方

Prior Authorization 审查助手

自动化医疗保险事前授权审核,生成可审计的审批、拒绝或待补件决定。

★ 425 FS 35 不推荐 1 个月前
效率与协作 ✓ Anthropic · 官方

合同证据分析器

在本地合同文件中检索条款、比较修订内容,并生成带验证引用的答案。

★ 425 FS 55 谨慎使用 1 个月前
开发与工程 ✓ Anthropic · 官方

文档纯文本提取器

将常见文档和医疗附件转换为可处理的纯文本。

★ 425 FS 52 谨慎使用 1 个月前
✓ Anthropic · 官方

ICD-10-CM 临床编码助手

将临床记录转换为可核验的出院诊断编码。

★ 425 FS 46 谨慎使用 1 个月前
开发与工程 ✓ Anthropic · 官方

合同引擎验证器

通过 MCP 标准输入端到端验证合同引擎改动。

★ 425 FS 44 不推荐 1 个月前
✓ Anthropic · 官方

临床程序编码助手

从临床文档提取可申报的CPT和HCPCS程序代码。

★ 425 FS 42 不推荐 1 个月前
数据与分析 ✓ Anthropic · 官方

临床试验方案设计器

为药物和医疗器械生成基于研究与监管要求的临床试验方案。

★ 425 FS 41 不推荐 1 个月前

相关 Skills