unisound-med-knowledge-qa

SKILL.md

---
name: med-llm-knowledge-qa
description: 医学考试、专科问答、文献阅读理解、名词规范解释与术语同义匹配等知识问答。由调用方传入题目，经内部医疗大模型作答；通过 --task 选择具体场景提示词；仅含 `scripts/run.py`，可独立拷贝部署。
metadata:
  {
    "openclaw":
      {
        "emoji": "🩺"
      }
  }
---

# 医学知识与专科问答

## 概述

覆盖医学知识检索、理解与规范表述类问答，依赖医疗大模型专业能力，按任务类型切换提示词。

具体场景通过 **`--task`** 切换系统提示词（见下表），能力依赖内部医疗大模型；集成方也可通过 `--system-prompt` 完全自定义。

| `--task` | 能力 |
| --- | --- |
| `exam` | 医学考试单项选择题 |
| `lit-qa` | 医学文献阅读理解问答 |
| `spe-qa` | 医学专科问答 |
| `synonym` | 医学术语同义匹配 |
| `term` | 医学名词规范解释 |

本能力与具体业务请求解耦：平台或调用方如何组织用户输入由集成方决定；此处只约定**如何把题目交给脚本**（见下）。

## 题目输入（三选一）

1. **`--question`**：直接传入完整题干字符串。  
2. **`--input PATH`**：  
   - `.jsonl`：每行一个 JSON 对象，须含非空字符串字段 `question`；可用 `--index` / `--batch` / `--match-id` 选取记录；  
   - `.json`：单个对象，须含 `question`；  
   - 其他扩展名：按 UTF-8 纯文本整文件作为题干。  
   - 传 `-` 时从 **stdin** 读取一条 JSON（含 `question`）或纯文本。  
3. **stdin**（且未传 `--question` / `--input`、且 stdin 非 TTY）：读入 JSON 对象或纯文本，规则同 `-`。

可在 JSON 的 `other.task` 中指定任务类型（与 `--task` 等价；命令行 `--task` 优先）。

## 模型

- 默认 `u1-insuremed`，接口 `https://maas-api.hivoice.cn/v1/chat/completions`（可通过参数覆盖）。

## 用法示例

```bash
# 指定任务类型与题干
python3 scripts/run.py --task exam --question "题干……" --appkey YOUR_KEY

# 从 jsonl 取题（other.task 可省略若命令行已传 --task）
python3 scripts/run.py --task exam --input /path/to/items.jsonl --index 0 --appkey YOUR_KEY
```

## 参数

- `--task`：**必填**（除非 `other.task` 已给出）。见上表。
- `--question` / `--input`：见上，与 stdin 三选一（`--question` 与 `--input` 不可同时使用）。
- `--appkey STRING`：**必填**（`--dry-run` 时除外）。内部医疗大模型鉴权 key。
- `--index`、`--match-id`、`--batch`：仅对 `.jsonl` 生效。
- `--dry-run`：不调用模型，仅输出解析后的题目 JSON。
- `--model`、`--api-url`、`--temperature`、`--timeout`、`--system-prompt`：调模型参数。
- `--output PATH`：另存完整 JSON（批量为 NDJSON）。
- `--text-only`：标准输出仅打印模型答案文本。

## 输出

默认可解析 JSON：含 `status`、`task`、`task_title`、`question`、`answer`、`record_index`、`meta`、`model`、`input_mode`、`input_path` 等；`skill` 为本 skill 标题。

## 合规说明

输出为模型辅助信息，不构成正式诊疗决策；涉及真实患者数据须先脱敏并遵守院内流程。