前言¶
处理体检数据最常见的痛点是:报告格式不统一。同样是「谷丙转氨酶」,电子版 PDF 里叫 ALT,扫描件里中文全称和英文缩写混排,手机拍的照片还有倾斜和阴影。拿到手之后,要么人工抄表到 Excel,要么写一次性脚本解析,第二年换一份报告格式又得改。等真的想做趋势分析时,还要再解决指标命名归一、参考区间比对、异常判定这几件事。
下面介绍的 Skill「体检指标趋势分析」就是针对这条链路的:输入三种形态的体检报告,输出统一的指标字典和多年趋势判定。
这是什么¶
一句话定位:一个面向体检报告的本地解析与趋势分析 Skill,把历年报告解析成结构化数据,再给出异常与趋好趋坏判定。
- 出品方:SkillHub 社区发布者 user_65c8c185
- 版本:1.2.0
- 分类:data-analysis
- 来源:community
- 官方地址:https://api.skillhub.cn/user_65c8c185/health-report-trend-analysis
- SkillHub 页面:https://www.skillhub.cn/skills/user_65c8c185/health-report-trend-analysis
- 是否需要 API Key:否(标签 requires_api_key=false)
它解决的问题是:不同年份、不同体检机构的体检报告无法直接比对。Skill 在解析阶段做指标命名归一,在比对阶段做跨年度趋势判断,最后产出可直接阅读的 Markdown 报告和离线 HTML 工作台。
核心功能¶
三种输入形态¶
1、电子版 PDF(带文本层),直接抽取文字。
2、扫描件 PDF,按图像方式处理。
3、照片 JPG,自动合成 PDF 后再解析。
三种形态最终走同一条解析链路,用户不需要先自己转格式。
统一指标字典(114 指标)¶
解析完成后产出一份统一指标字典,覆盖 114 个指标,用于把不同报告中的同义指标名归一到同一个键上。这是后续跨年度比对的前提:不做归一,同一项指标在不同年份会算成两个不同的字段。
历年趋势比对¶
按年份对齐同一指标,判定结果分三档:正常、显著变化、异常。趋势方向单独给出趋好或趋坏的判定。
趋势判定默认聚焦近三年,可用 --focus-years 配置。资料中未给出该参数的取值范围,需要以官方页面说明为准。
医学解读来源¶
解读部分引用的权威来源为默沙东诊疗手册、丁香医生与中国指南。Skill 只做指标层面的解读,不替代临床诊断。
输出物¶
1、结构化 Markdown 报告,便于直接阅读或进入版本管理。
2、离线 HTML 工作台,便于本地浏览和交互查看。
本地处理与脱敏¶
解析全程在本地完成,不需要外部 API(与 requires_api_key=false 一致)。处理过程中会自动生成脱敏数据集,避免原始报告里的身份信息随产物外流。
安装与启用¶
官方页面提供了 Skill 的坐标和分类信息:
@user_65c8c185/health-report-trend-analysis
该 Skill 基于通用 SKILL.md 格式,理论上可被支持该格式的编码助手加载。已抓取资料中没有给出具体的安装命令,也没有分别列出 Cursor、Codex CLI、Claude Code 的启用方式,因此这里不列命令,以免写错。启用前请打开官方页面核对当前版本的安装说明:
https://www.skillhub.cn/skills/user_65c8c185/health-report-trend-analysis
需要留意的是,无需 API Key 指的是 Skill 自身不依赖外部模型服务密钥,不等于运行环境不需要任何凭据,具体以官方说明为准。
典型用法¶
触发方式是自然语言描述需求。官方资料列出的触发词包括:体检报告、指标趋势、历年体检、健康管理、体检数据解析、化验单分析。
可复现的调用思路如下,具体参数名以官方文档为准:
输入:历年体检报告文件(PDF 或 JPG)
输出:指标字典 + 趋势比对结果 + Markdown 报告 + 离线 HTML 工作台
可调项:--focus-years(趋势分析聚焦的年数)
1、把一份或多份体检报告放进工作目录,格式可以是电子版 PDF、扫描件 PDF 或 JPG 照片。
2、用上述触发词发起请求,说明要做趋势分析。
3、从产物中取 Markdown 报告用于阅读,取指标字典和比对结果用于后续加工。
4、需要查看交互视图时打开生成的离线 HTML 工作台。
由于资料未给出完整的命令行示例和参数表,正式接入前建议先用一份报告做最小验证,确认解析覆盖到目标指标。
适用场景与注意¶
适合谁¶
1、需要把历年体检报告整理成可比较数据的开发者,希望省掉人工抄表和临时脚本。
2、做健康管理类应用的团队,需要一个指标归一层作为后续规则或模型的输入。
3、想离线处理体检资料、不希望报告内容离开本机的场景。
限制¶
1、只适用于体检/化验类文档,不适用于股票、账单、合同等非体检文档的分析。用在这类文档上不会得到有意义的指标字典。
2、指标字典覆盖 114 个指标,遇到字典外的检验项时,归一结果需要人工确认。
3、扫描件和照片的解析效果受原始质量影响:倾斜、阴影、低分辨率会降低抽取准确率。重要结论建议回看原始报告。
4、趋势判定默认只看近三年,做更长周期分析需要调 --focus-years,并确认该参数支持的范围。
5、医学解读来自公开权威来源,属于参考信息,不能替代医生判断。
结尾¶
这个 Skill 的价值在于把「解析格式 → 指标归一 → 跨年比对 → 产出报告」这条链路压缩成一步,并且三种输入形态统一走同一套解析逻辑,省掉了为不同报告格式分别写脚本的重复工作。全程本地处理、自动生成脱敏数据集这一点,对涉及个人体检资料的场景比较关键。
官方地址:https://api.skillhub.cn/user_65c8c185/health-report-trend-analysis
需要先确认安装方式的话,建议从 SkillHub 页面入手核对当前版本的启用说明。