技能介绍

要解决什么问题

在把 DICOM 序列交给转换器或推理管线之前，你往往需要先确认：目录里是否真的是同一序列、方向与模态是否合理、文件头里是否出现明显的 PHI 或工程上不可接受的结构。若一上来就解码像素或跑完整转换，成本高、失败也晚。本技能针对单个序列文件夹做仅读文件头的预检，输出结构化 JSON，供后续门控或人工复核——不承担去标识化、私有标签审查或临床放行。

技能如何工作

清单 I/O 约定清晰：输入为 dicom_dir，输出为 preflight_json。主入口是 scripts/preflight_series.py（以 skill_manifest.yaml 为准，不要用自写脚本替换上游入口）。脚本扫描该目录下的 DICOM 实例，不解码像素；JSON 中通常包含序列清单、方向 axcodes、PHI 相关标记、发现项，以及 preflight.verdict（取值为 pass、warn 或 fail）。

与校验器 verifiers/dicom_preflight_quality_v1 配合时，可按工程不变量检查输出，形成可留档的预检证据包。修改参数、副作用或校验门之前，应先阅读 skill_manifest.yaml；将本次运行视为有效证据前，需核对 JSON 与校验器指引。

适用边界与注意点

只读文件头：不检测烧录进像素的 PHI；对压缩传输语法、多帧实例多为警告，不进行解码。
方向门控：标准方向校验假设基于 LPS 的 CT axcodes 为 L、P、S；模态或坐标系不符时 verdict 可能误报或需人工解读。
范围：仅扫描单一目录，不在目录树中协调多检查点。
禁止用途：临床部署、合规性去标识化、自主诊断，或在未经审查的转换器下做生产级摄取。

截图预览

使用场景

将单个 CT/MR 序列文件夹交给 NIfTI 或重采样转换器之前，先产出含 `preflight.verdict` 的 JSON 再决定是否继续。
在 agent 编排里于推理或体数据构建前调用 `preflight_series.py`，用 pass/warn/fail 阻断明显不合规的输入路径。
批量处理时针对每个序列目录单独扫描，生成 `preflight_json` 并与 `dicom_preflight_quality_v1` 校验器对齐留档。
研究摄取管线向外部工具投递 DICOM 前，仅依据文件头检查 PHI 标记、清单与方向 axcodes，避免先解码像素。

适合人员

维护 PACS/科研摄取管线的医学影像工程师，需要在单序列转换或推理前做只读头预检门控。
用 DICOM 目录驱动 CT 推理或体数据管道的算法工程师，希望方向与模态异常时在入口即 fail。
负责 batch 转换与运行目录规范的数据平台工程师，要为每个 `dicom_dir` 产出可校验的预检 JSON 证据。
为宿主 agent 对接 `run_script` 与清单 I/O（`dicom_dir`→`preflight_json`）的集成开发者，需固定上游脚本入口。