mcpField
D
dicom-series-preflight

dicom-series-preflight

github.com/promptingcompany数据与数据库039 次安装17 周前更新
代码仓库

关于 dicom-series-preflight

Medical AI Skills 中的 DICOM 序列预检技能，在转换或推理前扫描单个序列目录并生成 JSON 报告。它只检查头信息，不解码像素，也不提供临床许可或去标识化。

主要功能

  1. 01扫描单个序列目录
  2. 02仅检查头信息
  3. 03生成清单与方向信息
  4. 04标记 PHI 并列出发现
  5. 05输出通过、警告或失败结论

适用场景

  1. 01转换前检查 DICOM 序列
  2. 02推理前查看序列清单与方向
  3. 03按预检结论设置工作流门控

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/promptingcompany/nv-skills --skill dicom-series-preflight

安装后在 Claude Code 中输入/dicom-series-preflight确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

BENCHMARK.md
skill_manifest.yaml
skill-card.md
skill.oms.sig
evals/
evals.json
fixtures/
generate_fixtures.py
scripts/
preflight_series.py
tests/
test_preflight_series.py
validators/
output_schema.json

详细介绍

DICOM 系列预检

用途

  • 用于在转换或推理前，对一个 DICOM 系列文件夹进行仅检查头信息的预检。不用于去标识化或临床准入。
  • 严格按照文档使用封装脚本；不要用手写实现替换上游入口点。
  • 清单 I/O：输入为 dicom_dir；输出为 preflight_json。

说明

  • 更改参数、副作用或验证门槛前，请先阅读 skill_manifest.yaml。
  • 通过下方所述命令运行 scripts/preflight_series.py；将输出保存在调用方提供的运行目录中。
  • 如果宿主 Agent 提供 run_script，请使用 run_script("scripts/preflight_series.py", args=[...])；否则运行下方所示的 Bash/Python 命令。
  • 在将本次运行视为证据前，请检查生成的 JSON 和配套的验证器指南。

可用脚本

脚本用途参数
scripts/preflight_series.pyskill_manifest.yaml 中声明的主要入口点。PATH_TO_DICOM_DIR

先决条件

  • 运行时要求：runtime.side_effects.pip_packages 中列出的 Python 包。
  • 除非下方已有章节另有说明，否则请从仓库根目录运行命令。

限制

  • 仅检查头信息；不会解码像素数据，也不会检测烧录的 PHI。
  • 规范方向门槛假定由 LPS 推导的 CT 轴代码为 L、P、S。
  • 对压缩传输语法和多帧实例只发出警告，不进行解码。
  • 仅扫描单个目录；不会协调同一目录树中的多个检查。
  • 不适用于临床部署、法规要求的去标识化、自主诊断，或未经过审核的转换器进行生产环境导入。

故障排除

错误原因修复方法
缺少依赖项或导入错误运行时软件包与 skill_manifest.yaml 中的声明不一致。安装清单中声明的软件包，或使用文档所述的设置命令。
输出为空或架构无效输入路径错误、不支持的模态，或上游故障。使用已知测试样例重新运行，并检查封装脚本生成的 JSON 及 stderr。
验证门槛未通过输出违反了已声明的工程不变量。保留未通过的证据包，并根据门槛消息修复输入或封装脚本代码。

扫描 DICOM 目录（每个文件夹仅含一个系列），不解码像素。 输出 JSON，其中包含清单、方向轴代码、PHI 标记、检查结果，以及 preflight.verdict，其值为 pass、warn 或 fail。

python scripts/preflight_series.py PATH_TO_DICOM_DIR

与 verifiers/dicom_preflight_quality_v1 配合使用，以生成可信的预检包：

make run-trusted SKILL=dicom_series_preflight \
  FIXTURE=skills/dicom-series-preflight/fixtures/clean_no_phi \
  OUT=runs/dicom_preflight_demo

旗舰工作流：

make run-workflow \
  WORKFLOW=examples/workflows/dicom_preflight_gate.yaml \
  WORKFLOW_INPUT=skills/dicom-series-preflight/fixtures/clean_no_phi \
  WORKFLOW_OUT=runs/dicom_preflight_gate

不用于去标识化、私有标签审查或临床准入。

评论

支持 Markdown