前言¶
体检报告或化验单上箭头、缩写和参考区间，对非医学背景的读者往往不友好。把整张单子丢给通用大模型，容易漏项、混用不同实验室的区间，或在用药和诊断边界上说得过满。下面介绍 SkillHub 上的社区 Skill「体检报告解读」（坐标 @user_70c2f807/health-report-interpreter），它把 51 项常见指标的对照、偏离分级和就诊导引写进 SKILL.md，并附带本地 Python 脚本，便于在 Agent 对话里复现同一套口径。
这是什么¶
「体检报告解读」是发布者 user_70c2f807 在 SkillHub 上架的 professional 类社区 Skill，当前版本 1.0.0，标签标明 requires_api_key=false（无需单独配置 API Key）。Skill 包内显示名称为「体检化验单解读」，定位是：把报告上的项目名、数值、单位与参考区间逐项对照公开临床参考区间（说明中引用 WS/T 405-2012 及 WS/T 404 系列），标出偏高/偏低与偏离程度，并给出常见影响因素与就诊科室导引；明确不做诊断、不判病、不给用药建议、不做疾病风险预测。
SkillHub 页面统计（以抓取资料为准）：评分 100000，下载 1264 次，安装记录为 0。官方入口：SkillHub 技能页。
核心功能¶
依据技能包内 SKILL.md，已核实的能力如下。
- 逐项对照：内置 51 项指标参考区间，按性别、年龄取区间；报告单上若印有区间，优先采用报告单区间。
- 偏离分级：按偏离比给出临界、轻度、中度、显著四档提示（技能文档注明为工具自定义口径，非临床分级标准）。
- 原因与导引：异常项附常见影响因素与建议就诊科室说明。
- 批量解读：支持整张贴报告单，自动跳过表头与注释，输出汇总表与异常明细。
- 三种输入形态：报告单原样粘贴、CSV/表格行、最简「项目名 + 数值」写法可混用。
- 子命令：
list（查指标与区间）、explain（单项解读）、panel（批量解读）；纯 Python 3 标准库，文档写明不联网。
覆盖板块包括血常规、肝功能、肾功能、血脂、血糖、电解质、甲状腺、尿常规等；逐项参考区间详见包内 references/reference-intervals.md。
安装与启用¶
安装前建议确认本机已有 SkillHub CLI（参见 SkillHub 安装说明）：
command -v skillhub && skillhub --version
未安装时可执行官方推荐的一键安装（完整包含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill 时，必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。官方页面给出的安装提示为：按 https://skillhub.cn/install/skillhub.md 安装 @user_70c2f807/health-report-interpreter。CLI 检索到的等价命令为：
skillhub install health-report-interpreter --namespace user_70c2f807 --dir <你的 skills 目录>
常见客户端 skills 路径（摘自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
以 Cursor 为例：
skillhub install health-report-interpreter --namespace user_70c2f807 --dir ~/.cursor/skills/
安装完成后，在对话中提及体检报告、化验单、指标是否异常等场景时，Agent 会按 SKILL.md 触发解读流程；需要确定性输出时，可在技能目录下直接调用脚本。
典型用法¶
下列示例均来自技能包 SKILL.md，可在安装目录内复现（将路径换成你本机解压后的位置）。
查看支持的指标与区间：
python3 scripts/health_report_interpreter.py list
python3 scripts/health_report_interpreter.py list --panel 肝功能
python3 scripts/health_report_interpreter.py list --keyword 胆固醇
解读单个指标：
python3 scripts/health_report_interpreter.py explain --item 谷丙转氨酶 --value 65 --sex male
python3 scripts/health_report_interpreter.py explain --item 肌酐 --value 1.2 --unit mg/dL --sex male --age 45
批量解读整张报告单：
python3 scripts/health_report_interpreter.py panel --input report.txt --sex female --age 52
python3 scripts/health_report_interpreter.py panel --input report.csv --json
cat report.txt | python3 scripts/health_report_interpreter.py panel --sex male
输入行示例（三种写法可混用）：
谷丙转氨酶(ALT) 65.0 ↑ 0-40 U/L
谷丙转氨酶,65,U/L,9-50
谷丙转氨酶 65
尿蛋白(PRO) 阴性
在 Agent 对话侧，用户粘贴整段化验单并提问「哪几项不正常」「甘油三酯多少算高」等，技能说明中列出的表述会触发同一套解读逻辑；脚本退出码 0 表示全部在区间内，1 表示存在异常或未识别行（结果仍会打印），2 表示参数或识别错误。
适用场景与注意¶
适合谁
- 需要把化验单指标对照参考区间、用统一口径做科普性说明的个人或家庭用户。
- 希望在 Cursor、Claude Code 等 Agent 里固定「不诊断、不开药」边界的开发者或内容运营者。
- 需要离线、可脚本复现的批量对照（
panel+--json），而不是每次完全依赖模型自由发挥的场景。
限制与注意
- 不同实验室方法与分析系统会导致参考区间不一致；技能要求报告单自带区间时以报告单为准。
- 偏离分级仅表示相对参考区间的幅度，不代表病情轻重；异常需结合症状与其他检查，由医生综合判断。
- 技能不提供诊断与用药建议；涉及疾病判断应线下就医。
- 若
skillhub install时未带--namespace user_70c2f807，可能装到其他同名技能，安装前建议在 SkillHub 搜索中确认坐标为@user_70c2f807/health-report-interpreter。
结尾¶
「体检报告解读」把 51 项常见化验指标的对照规则、偏离分级和就诊导引固化在 Skill 与本地脚本里，适合在 Agent 中处理「看不懂化验单」类问题，同时把医疗边界写清楚。需要安装或查看元数据时，可打开 SkillHub 官方页：https://www.skillhub.cn/skills/user_70c2f807/health-report-interpreter 。
