DICOM 序列预检
在转换或推理前快速验证单个 DICOM 序列目录。
证据显示仅扫描调用方指定的DICOM目录,声明无网络端点、无本地或主目录写入、无需GPU,并明确限制为头信息检查且不作临床或去标识化用途;Apache-2.0、NVIDIA作者和安全披露路径提供归属。扣分在于允许工具为Bash,执行边界和用户确认要求未明确,输出仍可能包含StudyDescription等敏感元数据,依赖版本较宽且无具体供应链缓解或回滚机制。
证据显示有清晰入口、参数、错误表、输出模式、manifest校验门、重复性配置和三项单元测试;异常输入可产生失败发现和错误信息。扣分在于本次未执行,关键路径不能静态复现;命令、manifest参数占位符和wrapper语境存在轻微不一致,缺少对权限、超大目录、部分可读数据及缺失spacing等边界的完整反馈。
证据明确面向开发者,在转换或推理前检查单个DICOM系列,输入目录、JSON输出、适用范围和非适用场景均有说明,也包含正负评测任务。扣分在于触发排除条件仍较概括,单目录和CT LPS假设限制适用面;中文交互支持、不同主机环境和中国大陆可达性没有证据,但核心功能不依赖海外服务。
证据显示SKILL.md、skill card、manifest、输出schema、脚本、fixtures、测试、限制、故障排查、版本0.1.0、Apache-2.0和NVIDIA所有者均存在,结构较完整。扣分在于缺少推荐的Examples章节,未见明确changelog、维护责任人/更新流程和依赖锁定,README中的仓库级信息不能完全替代技能自身治理说明。
证据显示脚本直接输出结构化JSON,覆盖库存、方向、PHI标志、一致性、发现和pass/warn/fail结论,三项评测任务与单元测试定义了清晰结果;静态材料还报告了准确性和安全性指标。扣分在于本次未执行,评测结果属于文件内报告而非本审查独立验证;只检查标准PHI标签、不解码像素,结果仍需人工和后续工具审阅,且相对手工或替代方案的增量价值证据有限。
证据包含固定修订范围内的源代码、schema、fixtures生成器、测试、manifest重复运行配置及评测报告,支持有限审计。扣分在于本次未执行,未见覆盖该技能关键路径的实际CI证据,评测报告缺少可独立核验的运行产物和完整测试覆盖,因此不能超过静态上限。
- 该技能不是去标识化工具:标准标签为空不代表无私有标签或烧录像素PHI,分享前仍需专用去标识化流程。
- Bash执行和读取DICOM敏感目录应由调用方明确授权并在隔离环境中运行;不要将pass或warn解释为临床适用或下游分割质量保证。
- 安装前应审查并锁定pydicom、nibabel、numpy和typer版本,并用实际环境运行测试与负例验证。
这个 Skill 能做什么,适合哪些场景?
该技能用于在转换或推理前,对一个 DICOM 序列目录执行仅限头信息的预检。它扫描单个目录,输出文件清单、方向轴码、PHI 标记、发现项以及 pass、warn 或 fail 判定。它不解码像素,也不用于去标识化或临床清 clearance。运行时必须使用技能规定的 Python 包、脚本入口和验证器指导。
读取调用方提供的 DICOM 目录,通过 scripts/preflight_series.py 执行单序列扫描;不解码像素数据;生成包含 inventory、orientation axcodes、PHI flags、findings 和 preflight.verdict 的 JSON;可配合 dicom_preflight_quality_v1 生成可信预检包。
- 医疗影像工程师在转换 DICOM 序列为其他格式前,检查目录和头信息是否满足工程门槛。
- 医学 AI 工程师在启动推理前,获取序列清单、方向轴码和预检判定。
- 数据管线开发者为单个序列目录生成结构化 JSON 预检结果。
- 验证或故障排查人员在预检失败时保留输出证据包,并根据门控消息修复输入或包装器。
这个 Skill 有哪些优点和局限?
- 输出结构化 JSON,并提供 pass、warn、fail 预检判定。
- 覆盖目录清单、方向轴码、PHI 标记和发现项。
- 可通过规定的验证器和工作流生成预检证据包。
- 明确要求使用上游脚本入口,减少手写替代实现带来的偏差。
- 仅检查头信息,不解码像素,也不能发现烧录在图像中的 PHI。
- 压缩传输语法和多帧实例只发出警告,不进行解码。
- 只扫描单个目录,不会协调同一树中的多个研究。
- 不适用于去标识化、私有标签审查、临床 clearance、生产摄取或自主诊断。
- skill_manifest.yaml 中的具体 Python 包名称在提供材料中未列出。
如何安装这个 Skill?
使用 NVIDIA 技能集合的 CLI 安装指定技能:
npx skills add nvidia/skills --skill dicom-series-preflight --yes
README 未说明该技能的独立安装包;安装后应让所用 Agent 重新加载技能。
如何使用这个 Skill?
从仓库根目录运行:
python scripts/preflight_series.py PATH_TO_DICOM_DIR
将 PATH_TO_DICOM_DIR 替换为一个 DICOM 序列目录,并将输出保存在调用方提供的运行目录中。检查生成的 JSON 及配套验证器指导后,再将结果视为证据。