med-critical-disease-review

SKILL.md

---
name: med-critical-disease-review
description: 重大疾病理赔智能评估（支持 28 种病种）。输入住院病历结构化数据，调用内网评估接口，输出原始 JSON 与自然语言结论（结论 + 证据）。
metadata:
  {
    "openclaw":
      {
        "emoji": "🏥"
      }
  }
---

# 重大疾病理赔评估

概述
----
给定一份住院病历（结构化 `medicalRecord`，含诊断/文书等），本技能调用内网评估服务，对 **任意重大疾病病种** 进行判定，并返回：

- **最终结论**：符合/不符合（来自 `final_result`）
- **原因与证据**：按条件逐条给出 evidence（可带来源 source）
- **原始结果**：接口返回的完整 JSON（便于追溯与二次加工）

数据安全、隐私与伦理声明
------------------------
- **最小必要原则**：仅处理完成评估所必需的数据字段；不要求提供与评估无关的身份信息。
- **严格脱敏**：在发送至任何模型/接口前，会对可识别个人身份的信息进行脱敏/去标识化处理（如姓名、证件号、手机号、详细地址、人脸/影像等）。仅传递脱敏后的必要信息用于本次 skill 调用。
- **不做本地持久化**：不将用户输入与中间结果写入本地持久化存储（包含磁盘文件、数据库、日志）。仅在内存中短暂处理；**本次调用结束即销毁**。
- **第三方 API 风险提示**：在功能需要时，可能会调用第三方模型/服务接口；此时仅会发送**脱敏后的必要信息**，并使用加密传输。除完成本次请求外，不用于任何其他用途（如训练、画像、营销）。
- **医疗边界**：本技能输出为理赔条款/条件匹配与证据整理的辅助信息，不构成医疗诊断或治疗建议；如涉及临床判断请以执业医生意见为准。

支持病种（28）
--------------
- 心脏瓣膜手术：`heart_valve_surgery`
- 主动脉手术：`aortic_surgery`
- 冠状动脉搭桥术：`coronary_artery_bypass`
- 重大器官或造血干细胞移植术：`major_organ_transplant`
- 恶性肿瘤——重度：`malignant_tumor`
- 严重慢性肾衰竭：`severe_chronic_kidney_failure`
- 严重慢性肝衰竭：`severe_chronic_liver_failure`
- 急性重症肝炎或亚急性重症肝炎：`acute_severe_hepatitis`
- 严重慢性呼吸衰竭：`severe_chronic_respiratory_failure`
- 严重特发性肺动脉高压：`severe_idiopathic_pulmonary_hypertension`
- 严重脑损伤：`severe_brain_injury`
- 深度昏迷：`deep_coma`
- 严重脑中风后遗症：`severe_stroke_sequelae`
- 严重阿尔茨海默病：`severe_alzheimers_disease`
- 严重原发性帕金森病：`severe_primary_parkinsons_disease`
- 严重运动神经元病：`severe_motor_neuron_disease`
- 严重脑炎后遗症或严重脑膜炎后遗症：`severe_brain_encephalitis_sequelae`
- 严重非恶性颅内肿瘤：`severe_non_malignant_intracranial_tumor`
- 瘫痪：`paralysis`
- 双耳失聪：`bilateral_deafness`
- 双目失明：`bilateral_blindness`
- 语言能力丧失：`language_ability_loss`
- 严重克罗恩病：`severe_crohn_disease`
- 严重溃疡性结肠炎：`severe_ulcerative_colitis`
- 重型再生障碍性贫血：`severe_aplastic_anemia`
- 较重急性心肌梗死：`moderate_acute_myocardial_infarction`
- 严重Ⅲ度烧伤：`severe_third_degree_burn`
- 多个肢体缺失：`multiple_limb_loss`

输入格式
--------
请求为 JSON（示例见 `../data/med-major-disease-assess/req_data.json`），推荐使用以下结构：

- `medicalRecord`：病历结构化对象
  - `hospitalId` / `admissionId`：可选，病例标识
  - `mainDiagName` / `otherDiagName`：诊断信息（字符串/JSON 字符串均可）
  - `docs`：文书列表（推荐每个 doc 含 `docName`、`nodes`、`format_page_text`）

也支持通过统一入口 `scripts/run.py` 直接输入 `pdf/doc/docx/xls/xlsx/csv/txt/json`。
预处理成功后，会先归一化为最小可用的 `medicalRecord.docs[]` JSON，再调用本 skill 的原始评估逻辑。

最小校验（先校验，再审核）
--------------------------
脚本会先对入参做最小结构校验，校验通过后才会调用审核接口：
- 请求体必须是 JSON object
- 必须包含 `medicalRecord`（object）
- `medicalRecord.docs` 必须是非空数组

后端接口
--------
- Base URL：`https://skills-medical.hivoice.cn`
- 方法：`POST`
- 路径：`/api/v1/assessment/assess/{disease}`
- 鉴权请求头：
  - `Authorization: Bearer <LLM_API_KEY>`
  - `Content-Type: application/json`
- 成功判定：
  - HTTP 200 且 `success=true`：请求处理成功（不代表一定理赔通过）
  - 业务结论看 `result.final_result.satisfied`：
    - `true`：满足条件
    - `false`：不满足，原因见 `result.final_result.reason`
- 常见错误：
  - `401`：缺少或错误的 `Authorization: Bearer <api_key>`
  - `200 + success=false`：业务处理失败，详见 `error`

快速开始
--------

```bash
# 在本目录下运行（统一入口）
python3 scripts/run.py \
  --disease aortic_surgery \
  --appkey <LLM_API_KEY> \
  --input ../data/med-major-disease-assess/req_data.json

# 或继续直接使用原始 medicalRecord JSON 入口
python3 scripts/major_disease_assess.py \
  --disease aortic_surgery \
  --appkey <LLM_API_KEY> \
  --input ../data/med-major-disease-assess/req_data.json
```

参数说明
--------
- `--disease STRING`
  - 病种类型（如：`aortic_surgery`、`heart_valve_surgery` 等）。
- `--appkey STRING`
  - **必填**。接口鉴权 key，请通过 `Authorization: Bearer <api_key>` 传递。
- `--input PATH`
  - 输入请求 JSON 路径（UTF-8）。
- `--output-json PATH`
  - 保存接口原始返回 JSON（默认：`../runs/med-major-disease-assess/{disease}_resp.json`）。
- `--output-text PATH`
  - 保存自然语言结论文本（默认：`../runs/med-major-disease-assess/{disease}_resp.txt`）。
- `--base URL`
  - 评估接口 base URL（默认：`https://skills-medical.hivoice.cn`）。
- `--timeout SECONDS`
  - HTTP 超时秒数（默认：60）。

统一入口附加参数（`scripts/run.py`）
----------------------------------
- `--input-type auto|pdf|doc|docx|xls|xlsx|csv|txt|json`
  - 输入类型；默认 `auto`。
- `--sheet STRING`
  - 读取 Excel 时指定 sheet（可选）。
- `--encoding STRING`
  - `txt/csv` 编码（默认：`utf-8`）。
- `--save-prepared`
  - 保存预处理后的 `medicalRecord` JSON，便于调试。

输出约定
--------
- 若指定输出路径的父目录不存在，会自动创建。
- 自然语言输出默认包含：
  - 结论（符合/不符合）
  - 原因（`final_result.reason`）
  - 逐条条件的证据（`conditions[*].evidence`，并附 `source/description`）

依赖
----
### 前置 Skill
本 skill 的 `scripts/run.py` 依赖 **`_shared/doc-preprocess`** 提供的公共文件预处理库（`preprocess.py`）。
请确保 `_shared/doc-preprocess/` 位于 `skills/` 根目录下。

### 运行环境
- Python 3.7+

### 外部 API
- 后端评估服务：`https://skills-medical.hivoice.cn/api/v1/assessment/assess/{disease}`
  - 方法：POST
  - 请求头必须包含：
    - `Authorization: Bearer <LLM_API_KEY>`
    - `Content-Type: application/json`

### Python 第三方包（可选，按输入格式需要）
| 包名 | 用途 | 必要条件 |
|------|------|---------|
| `openpyxl` | 读取 `.xlsx` 文件 | 输入为 xlsx 时必须 |
| `pypdf` | 提取 PDF 文本 | 输入为 pdf 时必须（或用 pdftotext 替代） |

安装：`pip install openpyxl pypdf`

### 外部工具（可选，按输入格式需要）
| 工具 | 用途 | 必要条件 |
|------|------|---------|
| LibreOffice (`soffice`) | 转换 `.doc` / `.xls` 为文本 | 输入为 doc/xls 时必须 |
| `pdftotext`（poppler-utils） | 提取 PDF 文本 | 输入为 pdf 且未安装 pypdf 时必须 |
| `tesseract`（含 chi_sim+eng 语言包） | 图片 OCR | 输入为 png/jpg/bmp/tif 等图片时必须 |

安装（Ubuntu/Debian）：`sudo apt-get install libreoffice poppler-utils tesseract-ocr tesseract-ocr-chi-sim`

> 仅使用 JSON 输入时，无需安装任何第三方包或外部工具。

备注
----
- **发布约束**：示例输入、运行输出、自测脚本均放在 skill 包外（分别位于 `../data/`、`../runs/`、`../self_tests/`），skill 目录内仅保留可发布的核心文件（`scripts/`、`SKILL.md`、`_meta.json`）。