fhir-developer-skill – FHIR 医疗数据开发 Skill

Skill 详细介绍

anthropics/healthcare#fhir-developer-skill 是 Anthropic 官方 healthcare 仓库下提供的一个面向医疗健康领域的开发类 Skill，目标用户是需要在医疗信息系统之间做数据互操作的开发者。FHIR（Fast Healthcare Interoperability Resources）是 HL7 组织发布的医疗数据交换标准，这个 Skill 的核心价值就是让 AI Agent 在编写、审查、调试 FHIR 相关代码和资源时，具备该领域的结构化知识。

它是什么

它是一套面向 FHIR 开发的 Agent 指令与知识集合，安装后 Agent 在处理 FHIR 相关任务时，会按照医疗数据交换的规范来组织输出，而不是给你一段泛泛的 REST API 代码。

它不是什么

它不是独立的软件，不是 npm 包，不是 CLI 工具，也不能脱离 Agent 单独运行。它不提供 FHIR 服务器，不替代 HAPI FHIR、Microsoft FHIR Server 这类真实的 FHIR 实现，也不托管任何患者数据。

主要解决的问题

FHIR 的规范体积很大，包含大量资源类型（Patient、Observation、Encounter、MedicationRequest 等）、Profile、Extension、CodeSystem、ValueSet 和版本差异（DSTU2 / STU3 / R4 / R5）。开发者如果不熟悉这套体系，很容易写出结构不合法、版本混用或扩展定义错误的资源。这个 Skill 的作用，是让 Agent 在这类任务中更贴近规范本身。

典型任务

– 生成符合 FHIR 规范的资源 JSON，例如 Patient、Observation、Encounter
– 编写 FHIR 资源之间的引用和 Bundle
– 编写针对 FHIR 接口的客户端代码或服务端逻辑
– 检查现有 FHIR 资源是否符合某个 Profile
– 处理版本差异（R4 与 R5 的资源结构变化）
– 理解 CapabilityStatement、SearchParameter、OperationDefinition 等元数据

工作方式

它主要通过向 Agent 注入 FHIR 领域知识和编写约定来工作。你在对话中提出 FHIR 相关需求，Agent 会基于这套知识来组织代码和资源结构。它不会自动去连接任何 FHIR 服务器，除非你在具体任务中让它这么做。

适合的用户

– 医疗信息化开发者
– 做 EHR / HIS / 健康档案系统的团队
– 需要对接医院或第三方医疗数据平台的工程师
– 研究 HL7 FHIR 标准、需要快速产出示例资源的人

不适合的需求

– 需要真实 FHIR 服务器或沙箱环境
– 需要生产级的医疗数据存储或合规认证
– 需要患者隐私数据处理与脱敏的完整解决方案
– 非 FHIR 的医疗数据格式（如 HL7 v2、C-CDA）的完整替代方案

它本质上是领域知识型 Skill，不是运行时组件，这一点直接决定了后面的安全评估和使用要求。

Skill 安全评估

总体判断：来源可信，风险主要不在 Skill 本身，而在你交给它处理和生成的内容。

来源可信度

该 Skill 位于 Anthropic 官方的 healthcare 仓库路径下，属于 Anthropic 组织直接维护的内容。相比第三方复刻版本，官方来源在可信度上是有优势的。安装时建议确认来源确实是 anthropics/healthcare，而不是名字相似的其他仓库。

权限与行为

作为知识型 Skill，它本身不需要你额外授予网络访问、Shell 执行或文件删除权限。它主要在对话层面影响 Agent 的输出。

真正需要关注的是 Agent 本身的权限。如果 Agent 同时开启了自动执行 Shell、自动写入文件，那么它在帮你生成 FHIR 资源或客户端代码时，也可能自动把文件写进项目目录。这个能力是否合理，取决于你的使用场景：

– 只是让 Agent 生成代码片段给你看，可以关闭自动执行与自动写入
– 需要它直接改项目文件，再按需开放

更稳妥的做法是：先让 Agent 输出内容，你确认无误后再落盘。

医疗数据的特殊风险

这是这个 Skill 最需要注意的地方。FHIR 场景经常涉及真实患者数据。请留意：

– 不要把真实患者隐私数据（PHI）直接粘贴进对话，除非你明确知道当前 Agent 的数据处理方式和合规边界
– 生成测试资源时，使用合成数据（Synthetic Data）而不是真实数据
– 如果 Agent 被授权访问真实的 FHIR 服务器，凭证和返回数据都会进入对话上下文

依赖与供应链

该 Skill 不强制引入 npm 或 pip 依赖。但它生成的代码可能会引用 FHIR 客户端库（例如 HAPI FHIR、fhir.js 等）。是否引入、引入哪个版本，由你决定，Skill 不会自动安装。

提示注入风险

如果 Agent 在处理过程中读取了外部 FHIR 服务器返回的内容或第三方文档，这些内容可能包含诱导性指令。建议在让 Agent 读取不可信来源时保持警惕。

降低风险的实操建议

1. 确认是从 anthropics/healthcare 官方路径获取
2. 生成 FHIR 资源时用合成数据，不贴真实患者信息
3. 不必要时关闭 Agent 的自动执行 Shell 与自动写入
4. 对 Agent 生成的 FHIR 资源，用官方校验器（如 HL7 Validator）复核后再上线
5. 涉及真实医疗系统对接时，凭证走独立的密钥管理，不要直接写在对话或代码里

Skill 使用要求

一、Agent / 客户端

该 Skill 由 Anthropic 官方发布，与 Claude Code 高度适配，优先在 Claude Code 中使用。

官方没有提供完整的第三方 Agent 兼容列表。从 Agent Skill 的一般工作方式来看，在支持 Skills、自定义指令或类似加载机制的环境中，通常也可以尝试在 Codex、Cursor、Trae、OpenClaw、WorkBuddy 等主流 AI Agent 中使用。不同 Agent 的 Skill 加载方式和兼容程度不同，具体以对应 Agent 当前版本为准。

二、运行环境 / 依赖

Skill 本身是知识型内容，不要求特定的运行时。

| 项目 | 要求 |
|—|—|
| Agent | Claude Code 优先，其他支持 Skill 的 Agent 可尝试 |
| Node.js | 非必需，仅当你后续开发的 FHIR 项目需要时 |
| Python | 非必需，仅当你后续开发的 FHIR 项目需要时 |
| Git | 非必需，视安装方式而定 |
| 网络 | 非必需；仅在需要访问外部 FHIR 服务器或文档时 |

官方没有明确强制某一种语言或版本，具体以你实际开发的项目栈为准。

三、权限

– 文件读取：可选。仅当你要让 Agent 读取项目里的 FHIR 文件
– 文件写入：可选。需要它直接改项目文件时再开
– Shell：可选。需要它执行本地校验或测试命令时再开
– 网络：可选。仅在需要访问真实 FHIR 服务器或在线规范时
– 浏览器：通常不需要

四、账号 / API Key

Skill 本身不需要账号或 API Key。

但如果你让它对接真实的 FHIR 服务器（例如某家医院或某个 FHIR 沙箱），那台服务器可能需要 OAuth 2.0、Bearer Token 或 SMART on FHIR 授权。这属于你后续项目的需求，不是 Skill 的安装前提。

最小使用条件

1. 一个支持该 Skill 的 Agent 环境（Claude Code 优先）
2. 能正常发起对话即可
3. 有 FHIR 相关的具体开发任务
4. 如需对接真实服务器，另外准备该服务器的访问凭证

Skill 安装、使用与卸载教程

一、安装

可以直接复制本页面提供的 Skill 安装指令，粘贴到对应 Agent 或终端中执行。

如果你不确定自己的 Agent 该怎么装，可以直接询问当前 AI Agent：

如何安装 anthropics/healthcare#fhir-developer-skill？

如何在 Claude Code 中安装 anthropics/healthcare#fhir-developer-skill？

如何在 Cursor 中安装 anthropics/healthcare#fhir-developer-skill？

让 Agent 根据自己的 Skill 加载与管理机制来指导安装。不同 Agent 的安装位置和命名方式可能不同，以当前 Agent 的实际机制为准。

二、安装后如何使用

安装后，在处理 FHIR 相关任务时 Agent 会自动参考这套知识。你不需要记住特殊命令，用自然语言描述需求即可。合适的任务类型包括：生成 FHIR 资源、编写接口代码、检查资源合规性、处理版本差异。

以下是一些可以直接说的例子：

使用 fhir-developer-skill，帮我生成一个符合 FHIR R4 规范的 Patient 资源，字段用合成数据。

使用 fhir-developer-skill，检查这个 Observation 资源是否符合 R4 规范，指出问题。

使用 fhir-developer-skill，帮我写一个用 Python 调用 FHIR 服务器查询患者就诊记录的客户端示例。

使用 fhir-developer-skill，说明 R4 和 R5 在这个资源的字段上有什么区别。

如果你的 Agent 支持在对话里直接指定 Skill，尽量在提问里点名该 Skill，避免 Agent 用了通用知识而不是 FHIR 专用知识。

三、卸载

保持简单，通常用以下方式之一即可：

– 使用对应 Agent 或 Skill 管理器提供的删除方式，找到该 Skill 后移除
– 直接询问当前 Agent：“如何卸载 anthropics/healthcare#fhir-developer-skill？”

不同 Agent 的 Skill 安装位置和管理方式可能不同。如果没有统一的卸载命令，直接询问当前 Agent 如何移除这个 Skill 通常更稳妥。

常见问题

1. 安装后 Agent 好像没识别到这个 Skill，怎么办？

先确认安装路径和加载方式是否符合当前 Agent 的机制。不同 Agent 对 Skill 的扫描目录和启用方式不同，装错位置是最常见的原因。可以直接问当前 Agent 它从哪里加载 Skill，再核对你的文件是否放对。

2. 可以同时装到多个 Agent 里吗？

可以。它本质是知识型内容，不绑定运行时。只要每个 Agent 都支持 Skill 加载，各自装一份即可，互不冲突。但要注意不同 Agent 的兼容程度不同，行为可能有差异。

3. Skill 更新后需要重新安装吗？

取决于你的安装方式。如果是从源仓库拉取并本地保存的，需要重新获取更新；如果是 Agent 支持自动同步的机制，可能会自动更新。具体以对应 Agent 的 Skill 管理方式为准。

4. 没有 FHIR 服务器也能用吗？

可以。它主要用于生成和检查 FHIR 资源与代码，不依赖在线服务器。你完全可以用它生成合成数据的资源、编写客户端代码，本地校验即可。

5. 它会自动修改我已有的项目文件吗？

不会自动修改，除非你给 Agent 开了文件写入权限，并且在任务里让它这么做。如果你只想看生成结果，可以关闭自动写入，让 Agent 只输出内容。

6. 中国大陆使用需要注意什么？

Skill 本身不强制联网，日常生成和检查 FHIR 资源在本地即可完成。只有当任务需要访问境外 FHIR 规范文档或第三方 FHIR 服务器时，才可能受网络条件影响。涉及真实医疗数据时，要注意数据出境相关合规要求。

7. 它和通用的 FHIR 客户端库是什么关系？

两者互补。Skill 负责让 Agent 理解 FHIR 规范和编写约定，客户端库负责在运行时真正调用 FHIR 服务器。Skill 不会替你安装或替换这些库，它只是让 Agent 在写这类代码时更贴近规范。