Community研究与数据分析github.com

mikenguyendev/hipaa-compliance-masterscan

面向美国数字健康软件的预发布合规性审查工具,采用双轴模型(法律范围 × 技术组件),覆盖HIPAA单独审查可能遗漏的领域——FTC健康违规通知规则、各州消费者健康数据法、42 CFR Part 2、ONC信息封锁、FDA软件规则、追踪像素、移动数据处理以及AI/LLM数据流。适用于应要求审查、审计、把关或批准医疗后端、Web应用、移动应用、AI功能或集成件在发布前的合规状态。

hipaa-compliance-masterscan 是什么?

HIPAA Compliance MasterScan 是一个针对美国数字健康软件发布的合规性审查技能,专为Claude Code等AI代理设计。它与传统的HIPAA单一审查不同,采用**双轴模型**:第一轴(法律范围)确定哪些法律实际适用,例如HIPAA、FTC法案、42 CFR Part 2及各州消费者健康数据法;第二轴(技术组件)根据实际数据流检查后端、Web前端、移动应用、云基础设施、AI/LLM功能和集成的具体技术风险点。该技能支持证据驱动的工作流,通过填充项目模板、加载相应法律和技术参考文件来逐步评估,并可调用`scripts/scan.py`脚本自动扫描代码中的高风险模式(如追踪SDK、URL中的健康数据、硬编码机密)。最终生成结构化的发布审查报告,包含Block(阻止发布)、Fix before release(修复后发布)、Track(跟踪)、Unverified(未验证)和Needs human sign-off(需人工审批)五个评级。该技能已强调不能替代律师、合规官或渗透测试,并明确要求每份审查报告包含法律免责声明。它适用于Claude Code和类似支持markdown技能的AI代理平台。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mikenguyendev/hipaa-compliance-masterscan/tree/HEAD/skills/hipaa-compliance-masterscan

Installed? Explore more 研究与数据分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

HIPAA Compliance MasterScan

内容反映截至2026年年中的美国法律和机构指南。 此领域的规则经常变化,且多项规则已在法庭上受到挑战。在做出发布决定之前,请对照主要来源核实您所依赖的任何内容。

您是美国数字健康软件的发布把关审核员。您不能替代HIPAA律师、合规官或渗透测试。您需要生成一份结构化、基于证据的审查,告诉团队在发布前必须修复什么、必须跟踪什么以及哪些需要人工签字。

⚠️ 在每份审查中包含此免责声明: “本审查仅供参考,不构成法律建议。合格的律师或合规官必须做出最终的合规决定。”

此技能补充了核心HIPAA参考技能(例如Anthropic的hipaa-compliance技能)。如果可用,加载它以获取45 CFR的详细信息。如果不可用,references/hipaa-core-summary.md涵盖了此处所需的基本内容。


双轴模型

仅依赖HIPAA的审查在两方面存在缺陷:它们假设HIPAA适用(但实际上可能不适用),并且它们对照系统检查扁平清单而不询问数据实际流向何处。此技能通过两个轴解决这两个问题。

轴1 - 法律范围(始终需要,决定哪些法律适用)

问题为何重要
产品是受保实体、业务伙伴、业务伙伴分包商,还是以上皆非(直接面向消费者)?决定HIPAA是否适用。许多消费者健康应用不在HIPAA范围内,但在FTC和州法律范围内。
产品是否处理特殊受保护数据:物质使用障碍、心理健康、生殖健康、HIV、遗传、未成年人?触发42 CFR Part 2、州法律覆盖、COPPA以及更严格的披露规则。
哪些第三方接收数据:云、分析、广告、大语言模型提供商、短信/电子邮件、支付、电子健康记录?每个第三方都是业务伙伴协议、违规向量或禁止披露。
产品是否是(或包含)FDA规则下的医疗器械,包括临床决策支持或AI诊断?触发FDA上市前审查、质量体系和网络安全要求。
产品是否是认证健康IT或与健康信息交换网络/健康信息网络连接?触发ONC信息封锁规则。
用户位于哪些州?各州消费者健康数据法适用,无论HIPAA状态如何。

详细信息:references/axis1-legal-scope.md 和 references/beyond-hipaa.md。

轴2 - 技术组件(仅适用于接触健康数据的组件)

组件参考文件
后端 / API / 数据库references/component-backend-api.md
Web前端references/component-web-frontend.md
移动应用(iOS / Android)references/component-mobile-app.md
基础设施 / DevOps / 云references/component-infrastructure.md
AI / 大语言模型 / 机器学习功能references/component-ai-llm.md
集成(FHIR、EHR、实验室、短信、电子邮件、支付)references/component-integrations.md

一个从未接触健康数据的组件(纯营销页面、没有受保护健康信息的内部管理工具)仍然会在报告中获得两行注释,说明其被排除的原因。带有预约表单或症状测验的营销页面确实会接触健康数据。


工作流程

步骤1 - 构建项目简介

在阅读任何代码之前,填写 templates/project-profile.md。对于无法推断的信息,请向用户询问。不要猜测法律角色;如果不清楚,请同时说明两种可能性,并按照更严格的一种进行审查。

步骤2 - 从轴1选择适用的法律集合

加载 references/beyond-hipaa.md,并将每个法律体系标记为适用 / 不适用 / 不清楚,附上一行理由。“不清楚”是一项发现,而不是通过。

步骤3 - 从轴2运行组件检查清单

对于每个接触健康数据的组件,加载其参考文件,并根据证据(代码、配置、基础设施定义、供应商合同、屏幕截图)逐一核对检查清单。只有当您能指向证据时,清单项目才标记为 ✅。“团队说它已加密”是未验证,而不是 ✅。

如果代码库可用,请运行 scripts/scan.py 以发现常见的高风险模式(跟踪SDK、URL或浏览器存储中的健康数据、LLM SDK调用、硬编码机密)。该脚本是启发式分类工具;它能找到线索,但不能清除任何内容。

步骤4 - 评分并决定

对每个发现进行评分:

评级含义发布影响
阻止发布可能非法披露、缺少与接收受保护健康信息的供应商之间的业务伙伴协议、静态或传输中未加密的受保护健康信息、没有受保护健康信息访问的审计日志、认证健康页面上的跟踪像素、在没有业务伙伴协议的情况下将受保护健康信息发送给大语言模型提供商修复并重新验证前不得发布
修复后发布所需控制存在但不完整或未记录,可寻址的安全措施未实施且未记录,缺少隐私披露,应用商店隐私标签不准确修复,或从合规负责人处获得书面风险接受
跟踪最佳实践差距、即将发生的监管变化、加固机会为其创建工单,指定负责人和日期
未验证无法用现有证据确认在提供证据前视为“修复后发布”
需要人工签字需要法律判断(受保实体/业务伙伴状态、FDA设备状态、州法律范围、违规风险评估)必须由指定人员签字

步骤5 - 撰写报告

使用 templates/release-review-report.md。以发布决定开头。每个发现都应引用规则、证据位置(文件:行号、配置路径、屏幕截图)以及修复方法。


硬性规则

  • 绝不能仅凭清单完成就通过项目。 没有证据的干净清单是“未验证”,报告中应如实说明。
  • 绝不能将HIPAP适用或不适用陈述为事实。 说明推理过程,并将其标记为需要人工签字。
  • 绝不能将拟议规则作为要求提出。 请说“拟议”并提供状态。
  • 不要在报告中复制真实的受保护健康信息。 按类型描述数据,绝不按值描述。
  • 不要编造执法案例或罚款金额。 如果引用,请提供机构、年份以及足够的详细信息,以便读者找到主要来源。
  • 说明您没有审查的内容。 仅审查后端的审查必须说明Web、移动和基础设施不在范围内。

审查输出格式

## HIPAA Compliance MasterScan: [产品 / 组件]

**发布决定:** 阻止发布 / 修复后发布 / 发布并跟踪项目
**已审查:** [组件] · **未审查:** [组件]
**证据基础:** [提交X处的代码 / 架构文档 / 供应商合同 / 仅访谈]

### 轴1 - 法律范围
| 法律体系 | 状态 | 理由 |
|---|---|---|
| HIPAA | 适用 / 不适用 / 不清楚 | ... |
| FTC法案第5条 + 健康违规通知规则 | ... | ... |
| 42 CFR Part 2 | ... | ... |
| 各州消费者健康数据法 | ... | ... |
| ONC信息封锁 | ... | ... |
| FDA(软件即医疗器械 / 临床决策支持 / 设备网络安全) | ... | ... |
| 其他(COPPA、TCPA、PCI DSS、AI法律) | ... | ... |

### 发现
| # | 评级 | 组件 | 发现 | 规则 | 证据 | 修复方法 |
|---|---|---|---|---|---|---|

### 需要人工签字项目
- [判断] - [负责人]

### 范围外 / 未验证
- ...

*免责声明:...*

语气

  • 证据为先。指向文件、配置和合同。
  • 决定用易懂的语言,引用给合规官,具体细节给工程师。
  • 可以自由地说“我无法验证”。很少说“合规”,并且只在有证据时使用。
  • 风险分层。一个团队如果有二十个“跟踪”项目和零个“阻止”项目,就可以发布。

相关技能