mcpField
T
tooluniverse-clinical-risk-scoring

tooluniverse-clinical-risk-scoring

github.com/mims-harvard其他1.8k119 次安装2 天前更新
代码仓库

关于 tooluniverse-clinical-risk-scoring

这是一个 ToolUniverse 技能,可将临床情境对应到经验证的风险评分,运行确定性计算器并说明结果。它用于临床决策支持,不能替代临床判断。

主要功能

  1. 01将情境映射到风险评分
  2. 02计算十种临床评分
  3. 03返回评分组成项
  4. 04说明临床解释
  5. 05提示配对评分的用法
  6. 06列明使用限制

适用场景

  1. 01评估房颤患者的卒中与出血风险
  2. 02估计肺炎严重程度或脓毒症风险
  3. 03判断 DVT 或 PE 的验前概率
  4. 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-65ClinicalCalc_CURB_65
疑似脓毒症(感染 + 可能的病情恶化)qSOFAClinicalCalc_qSOFA
肝硬化/慢性肝病严重程度Child-Pugh 和 MELD-Na(成对使用)ClinicalCalc_Child_Pugh + ClinicalCalc_MELD_Na
疑似 DVT——验前概率Wells DVTClinicalCalc_Wells_DVT
疑似 PE——验前概率Wells PEClinicalCalc_Wells_PE
CVD 一级预防——10 年风险/是否使用他汀?ASCVDClinicalCalc_ASCVD_risk
肾功能/肾脏药物剂量调整/CKD 分期eGFR CKD-EPIClinicalCalc_eGFR_CKD_EPI

当情景指定了一对评分时,务必同时计算两者——单独使用其中一个会产生误导(例如,只评估卒中风险而不评估出血风险,或只使用 Child-Pugh 而不使用 MELD-Na)。

步骤 2 — 收集所需输入

各工具的必填与可选输入(省略的布尔值默认为 false/不存在;省略必填标量值时会被拒绝):

工具必填主要可选布尔值/数值
ClinicalCalc_CHA2DS2_VAScagechf、hypertension、diabetes、stroke_history(2 分)、vascular_disease、female
ClinicalCalc_HAS_BLEDagehypertension、renal_disease、liver_disease、stroke_history、bleeding_history、labile_inr、drugs、alcohol
ClinicalCalc_CURB_65ageconfusion、elevated_urea(BUN>19)、high_resp_rate(>=30)、low_bp
ClinicalCalc_qSOFA(无)high_resp_rate(>=22)、altered_mentation、low_sbp(<=100)
ClinicalCalc_Child_Pughbilirubin、albumin、inrascites(none/mild/moderate)、encephalopathy(none/grade1-2/grade3-4)
ClinicalCalc_MELD_Nacreatinine、bilirubin、inr、sodiumdialysis(会将 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_riskage(40-79)、total_cholesterol、hdl_cholesterol、systolic_bpbp_treated、smoker、diabetes、female、race("white"/"black")
ClinicalCalc_eGFR_CKD_EPIcreatinine、agefemale

如果缺少必填值,请向用户询问——不要猜测。明确说明你将哪些布尔值假定为 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 年生存率(约)含义
A5–6~100%代偿良好
B7–9~80%功能受损显著
C10–15~45%失代偿;手术 / 麻醉风险高
MELD-Na(90 天死亡率 / 移植优先级,6–40)
MELD-Na90 天死亡率(约)移植相关性
<=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
>=2DVT 可能性高进行加压超声检查
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分期备注
>=90G1正常(仅在存在其他损伤指标时才诊断为 CKD)
60–89G2轻度降低
45–59G3a轻至中度
30–44G3b中至重度
15–29G4重度——转诊肾脏科
<15G5肾衰竭
使用 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 与尿素)。
  • 不能替代机构规程、指南更新或专科会诊。

评论

支持 Markdown