DICOM 元数据提取

要解决什么问题

医疗影像流水线里，Agent 或自动化任务常常只需要读懂一份 DICOM 的头部信息：传输语法、模态、Study/Series/Image 层级字段，以及标准标签里是否可能带有 PHI（受保护健康信息）。手写 pydicom 解析容易和清单约定不一致，也难和下游校验门对齐。

本技能面向单文件、工程向的元数据抽取：输入 dicom_path，输出结构化 metadata_json，并显式给出 phi_present 与 phi_tags_found，便于做证据包与质量校验——不是去标识化工具，也不做临床解读。

技能如何工作

• 以 skill_manifest.yaml 声明的 scripts/extract_metadata.py 为唯一上游入口；参数为 DICOM 路径，可选 --output 指定 JSON 路径。
• 内部用 pydicom 读取单个文件，向 stdout（或指定文件）输出 JSON，包含 transfer_syntax、modality、分组的 study/series/image 元数据，以及 PHI 相关标记。
• 清单 I/O 固定为：输入 dicom_path，输出 metadata_json。运行后应对生成 JSON 做人工抽查，并对证据包执行 medagent.verifiers.dicom_metadata_quality_v1，再视为可审核证据。
• 文档将其定位为医疗 AI Skills 里最小的端到端示例：封装脚本、清单、校验门一条链跑通。

适用边界

• 仅覆盖受 PS3.15 启发的标准标签子集，不是完整的 Basic Application Confidentiality Profile。
• 不检查私有标签，不检测烧录进像素的 PHI；多帧支持极其有限。
• 不可用于临床部署、合规去标识化、自主诊断或面向患者的用途。修改参数或副作用前，应先读清单；不要用自写实现替换封装入口。