关于 tooluniverse-clinical-risk-scoring
这是一个 ToolUniverse 技能,可将临床情境对应到经验证的风险评分,运行确定性计算器并说明结果。它用于临床决策支持,不能替代临床判断。
主要功能
- 01将情境映射到风险评分
- 02计算十种临床评分
- 03返回评分组成项
- 04说明临床解释
- 05提示配对评分的用法
- 06列明使用限制
适用场景
- 01评估房颤患者的卒中与出血风险
- 02估计肺炎严重程度或脓毒症风险
- 03判断 DVT 或 PE 的验前概率
- 04辅助肝硬化、心血管或肾脏评估
MCP 相关
提供十种用于临床风险评分的纯计算 ToolUniverse 计算器工具;README 说明它们无需网络或 API 密钥。
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ mims-harvard/ tooluniverse --skill tooluniverse-clinical-risk-scoring安装后在 Claude Code 中输入/tooluniverse-clinical-risk-scoring确认已加载。
附带文件evals/evals.json
详细介绍
临床风险评分
将临床情景对应到合适的经验证风险评分,使用确定性计算器工具计算,并将结果解读为临床行动。所有 10 个底层工具均为纯计算工具(无需网络或 API 密钥),并返回 {status, data:{score, interpretation, components, ...}}。
此技能仅用于决策支持——请参阅 LIMITATIONS。它不能替代临床判断。
步骤 1 — 将情景对应到评分
| 临床情景 | 评分 | 工具 |
|---|---|---|
| 心房颤动——卒中风险/是否抗凝? | CHA2DS2-VASc 和 HAS-BLED(成对使用) | ClinicalCalc_CHA2DS2_VASc + ClinicalCalc_HAS_BLED |
| 社区获得性肺炎——严重程度/是否住院? | CURB-65 | ClinicalCalc_CURB_65 |
| 疑似脓毒症(感染 + 可能的病情恶化) | qSOFA | ClinicalCalc_qSOFA |
| 肝硬化/慢性肝病严重程度 | Child-Pugh 和 MELD-Na(成对使用) | ClinicalCalc_Child_Pugh + ClinicalCalc_MELD_Na |
| 疑似 DVT——验前概率 | Wells DVT | ClinicalCalc_Wells_DVT |
| 疑似 PE——验前概率 | Wells PE | ClinicalCalc_Wells_PE |
| CVD 一级预防——10 年风险/是否使用他汀? | ASCVD | ClinicalCalc_ASCVD_risk |
| 肾功能/肾脏药物剂量调整/CKD 分期 | eGFR CKD-EPI | ClinicalCalc_eGFR_CKD_EPI |
当情景指定了一对评分时,务必同时计算两者——单独使用其中一个会产生误导(例如,只评估卒中风险而不评估出血风险,或只使用 Child-Pugh 而不使用 MELD-Na)。
步骤 2 — 收集所需输入
各工具的必填与可选输入(省略的布尔值默认为 false/不存在;省略必填标量值时会被拒绝):
| 工具 | 必填 | 主要可选布尔值/数值 |
|---|---|---|
ClinicalCalc_CHA2DS2_VASc | age | chf、hypertension、diabetes、stroke_history(2 分)、vascular_disease、female |
ClinicalCalc_HAS_BLED | age | hypertension、renal_disease、liver_disease、stroke_history、bleeding_history、labile_inr、drugs、alcohol |
ClinicalCalc_CURB_65 | age | confusion、elevated_urea(BUN>19)、high_resp_rate(>=30)、low_bp |
ClinicalCalc_qSOFA | (无) | high_resp_rate(>=22)、altered_mentation、low_sbp(<=100) |
ClinicalCalc_Child_Pugh | bilirubin、albumin、inr | ascites(none/mild/moderate)、encephalopathy(none/grade1-2/grade3-4) |
ClinicalCalc_MELD_Na | creatinine、bilirubin、inr、sodium | dialysis(会将 creatinine 设为 4.0) |
ClinicalCalc_Wells_DVT | (无) | active_cancer、immobilization、recent_surgery、localized_tenderness、leg_swollen、calf_swelling、pitting_edema、collateral_veins、previous_dvt、alternative_diagnosis(-2) |
ClinicalCalc_Wells_PE | (无) | clinical_dvt(3)、pe_most_likely(3)、tachycardia(1.5)、immobilization(1.5)、previous_vte(1.5)、hemoptysis(1)、malignancy(1) |
ClinicalCalc_ASCVD_risk | age(40-79)、total_cholesterol、hdl_cholesterol、systolic_bp | bp_treated、smoker、diabetes、female、race("white"/"black") |
ClinicalCalc_eGFR_CKD_EPI | creatinine、age | female |
如果缺少必填值,请向用户询问——不要猜测。明确说明你将哪些布尔值假定为 false。
步骤 3 — 计算
tu run ClinicalCalc_CHA2DS2_VASc '{"age":76,"female":true,"hypertension":true,"diabetes":true}'
每个工具都会返回 data.score、易于理解的 data.interpretation 以及按因素列出的分值明细 data.components。MELD/eGFR/ASCVD 还会返回 unit;Child-Pugh 会返回 child_pugh_class;Wells PE 会返回 three_tier 和 two_tier。请一并提供 components,以便用户核查哪些因素影响了评分。
步骤 4 — 解读(各评分对照表)
CHA2DS2-VASc(AF 卒中风险,0–9)
| 评分 | 卒中风险 | 行动 |
|---|---|---|
| 0(男性)/1(女性,仅性别分) | 低 | 不进行抗凝 |
| 1(男性) | 中等 | 考虑抗凝 |
| >=2(男性)/>=3(女性) | 升高 | 建议口服抗凝 |
HAS-BLED(抗凝治疗期间大出血风险,0–9)
| 分数 | 出血风险 | 处理措施 |
|---|---|---|
| 0–2 | 低至中等 | 可以考虑抗凝治疗 |
| >=3 | 高 | 谨慎处理;纠正可逆因素(血压、INR 不稳定、抗血小板药物/NSAID、饮酒),并加强随访——这并非自动禁忌证 |
如何综合权衡 CHA2DS2-VASc 和 HAS-BLED
HAS-BLED 高本身并不能作为不进行抗凝治疗的理由。如果 CHA2DS2-VASc 达到阈值,抗凝治疗带来的卒中获益通常大于出血风险;HAS-BLED 则用于提示需要纠正的可调整风险因素,以及需要加强监测的患者。只有出血风险极高且不可调整时,才会使决策倾向于不进行抗凝治疗。
CURB-65(CAP 严重程度,0–5)
| 分数 | 30 天死亡率 | 处理方式 |
|---|---|---|
| 0–1 | 低(约 1.5–3%) | 门诊治疗 |
| 2 | 中等(约 9%) | 短期留观 / 住院 |
| 3–5 | 高(约 15–40%) | 住院;分数为 4–5 时评估是否需要入住 ICU |
qSOFA(脓毒症筛查,0–3)
| 分数 | 含义 |
|---|---|
| 0–1 | 风险较低——不能排除脓毒症;需重新评估 |
| >=2 | 结局不良风险较高——升级处理,开展完整的脓毒症检查,考虑完整 SOFA 评分 / 乳酸检测 |
| qSOFA 是一种筛查工具,不是诊断;分数低绝不能排除脓毒症。 |
Child-Pugh(肝硬化严重程度,A/B/C 级)
| 等级 | 分数 | 1 年生存率(约) | 含义 |
|---|---|---|---|
| A | 5–6 | ~100% | 代偿良好 |
| B | 7–9 | ~80% | 功能受损显著 |
| C | 10–15 | ~45% | 失代偿;手术 / 麻醉风险高 |
MELD-Na(90 天死亡率 / 移植优先级,6–40)
| MELD-Na | 90 天死亡率(约) | 移植相关性 |
|---|---|---|
| <=9 | ~2% | 优先级低 |
| 10–19 | ~6% | |
| 20–29 | ~20% | 分配优先级上升 |
| 30–39 | ~50% | 优先级高 |
| >=40 | >50% | 优先级最高 |
| 结合 Child-Pugh 评分:Child-Pugh 分级用于评估慢性严重程度 / 手术风险;MELD-Na 用于评估短期死亡率和移植列名优先级。 |
Wells DVT(验前概率)
| 分数 | 概率 | 检查流程 |
|---|---|---|
| <2(尤其是 <=0) | DVT 可能性低 | D-二聚体;若为阴性,则排除 DVT |
| >=2 | DVT 可能性高 | 进行加压超声检查 |
Wells PE(验前概率)
| 两级分类 | 三级分类 | 检查流程 |
|---|---|---|
| PE 可能性低(<=4) | 低(0–1)/中等(2–6) | D-二聚体;若为阴性,则排除 PE(若可能性极低,可考虑 PERC) |
| PE 可能性高(>4) | 高(>6) | CT 肺动脉造影(D-二聚体不足以排除) |
ASCVD 10 年风险(%)
| 风险 % | 分类 | 他汀治疗建议(共同决策) |
|---|---|---|
| <5% | 低 | 生活方式干预 |
| 5–7.4% | 临界 | 存在风险增强因素时考虑治疗 |
| 7.5–19.9% | 中等 | 可考虑中等强度他汀 |
| >=20% | 高 | 高强度他汀 |
eGFR CKD-EPI(mL/min/1.73m^2)→ CKD 分期
| eGFR | 分期 | 备注 |
|---|---|---|
| >=90 | G1 | 正常(仅在存在其他损伤指标时才诊断为 CKD) |
| 60–89 | G2 | 轻度降低 |
| 45–59 | G3a | 轻至中度 |
| 30–44 | G3b | 中至重度 |
| 15–29 | G4 | 重度——转诊肾脏科 |
| <15 | G5 | 肾衰竭 |
| 使用 eGFR 进行肾脏药物剂量调整和 CKD 分期;单次数值只是估算值——需通过复查 / eGFR 变化趋势确认分期。 |
示例 A — 房颤,权衡抗凝治疗(配对评分)
76 岁女性,患有 AF、高血压和 2 型糖尿病;正在使用 NSAID;既往无卒中 / 出血,血压控制良好,INR 稳定。
tu run ClinicalCalc_CHA2DS2_VASc '{"age":76,"female":true,"hypertension":true,"diabetes":true}'
# -> score 5: "Elevated risk (5) — oral anticoagulation recommended"
# components: Age>=75 2, Hypertension 1, Diabetes 1, Female 1
tu run ClinicalCalc_HAS_BLED '{"age":76,"hypertension":true,"drugs":true}'
# -> score 3: "High bleeding risk (3) — caution, review reversible factors"
# components: Hypertension_uncontrolled 1, Elderly_>65 1, Drugs_antiplatelet_NSAID 1
解读。 CHA2DS2-VASc 为 5(女性阈值 >=3)→ 建议抗凝治疗。HAS-BLED 为 3,属于高风险,但该评分由可调整因素驱动:停用 NSAID 并控制血压后,3 个评分点中的 2 个会消失,从而降低出血风险。HAS-BLED 高不会抵消抗凝治疗的必要性——它提示你应纠正可逆风险并加强监测。
示例 B — 肝硬化严重程度与移植优先级(成对使用)
肝硬化患者:胆红素 3.5 mg/dL,白蛋白 2.5 g/dL,INR 2.4,中度腹水,1–2 级脑病;肌酐 2.0,钠 128,未接受透析。
tu run ClinicalCalc_Child_Pugh '{"bilirubin":3.5,"albumin":2.5,"inr":2.4,"ascites":"moderate","encephalopathy":"grade1-2"}'
# -> score 14, child_pugh_class "C": "Class C (score 14): decompensated disease"
tu run ClinicalCalc_MELD_Na '{"creatinine":2.0,"bilirubin":5.0,"inr":2.0,"sodium":128,"dialysis":false}'
# -> score 31: "MELD-Na 31: very high ... 90-day mortality risk"
解读。 Child-Pugh C 级(14 分)= 肝硬化失代偿,手术/麻醉风险极高——应避免择期手术。MELD-Na 31 表示 90 天死亡率约为三分之一或更高,移植分配优先级较高。两者结合,足以支持紧急肝病科/移植评估。(注意:MELD 使用了该患者化验结果中的胆红素 5.0 和 INR 2.0;内部会将低于 1.0 的数值按 1.0 处理。)
完整性检查清单
- 选择了与场景相符的评分——成对评分均已计算(CHA2DS2-VASc+HAS-BLED、Child-Pugh+MELD-Na)
- 确认了所有必需输入;对缺失项进行了询问,而非猜测
- 说明了哪些可选布尔值假定为
false - 报告了
score、interpretation和components明细 - 根据解读表将评分对应到临床行动
- 对于成对评分,说明了如何综合权衡两项评分
- 说明了 LIMITATIONS 中的注意事项(决策支持、适用人群、ASCVD 年龄 40–79 岁)
LIMITATIONS
- 仅用于决策支持。 这些评分可为临床判断提供参考,但不能替代临床判断和完整的临床情况。不得将输出表述为治疗指令。
- 适用人群有限。 每项评分均在特定队列中推导/验证,未必适用于儿童、妊娠、瓣膜性 AF(CHA2DS2-VASc 适用于非瓣膜性 AF)或其他被排除人群。
- ASCVD 汇总队列方程仅适用于年龄 40–79 岁的人群,以及 White/African-American 系数集;对其他族裔的估算可能有误,且仅用于一级预防(此前没有 ASCVD 事件)。
- eGFR CKD-EPI 假设肾功能稳定(肌酐处于稳态);在急性肾损伤、肌肉量极端异常或截肢患者中并不可靠,单次结果本身不足以进行 CKD 分期。
- qSOFA / CURB-65 / Wells 是筛查/验前概率工具——令人放心的评分不能排除诊断;应结合临床直觉和确证性检查。
- MELD-Na / Child-Pugh 适用于慢性肝病;无法反映急性肝衰竭或肝细胞癌的例外加分。
- 输入数据按原样处理——输入有误,输出也会有误。输入前请核实化验单位(mg/dL 与 mmol/L、BUN 与尿素)。
- 不能替代机构规程、指南更新或专科会诊。