医学量表检索技能

SKILL.md

---
name: medical-scale-research
description: 医学量表信息检索与标准化报告生成。通过浏览器自动化检索量表背景、版权、CDISC 映射、统计方法等信息，生成飞书云文档并保存到量表知识库。
---

# 医学量表 Skill - medical-scale-research

## PURPOSE

通过浏览器自动化检索医学量表的完整信息（背景、版权、CDISC 映射、统计方法等），生成标准化的飞书云文档，并保存到量表知识库。支持版本追踪和增量更新。

## WHEN TO USE

### TRIGGERS
- "检索 [量表名] 量表的信息"
- "整理 [量表名] 量表的报告"
- "查询 [量表名] 的 CDISC domain"
- "更新 [量表名] 量表的版本信息"
- "[量表名] 量表的统计分析方法是什么"

### DO NOT USE WHEN
- 需要访问付费墙后的完整文献（只能获取摘要）
- 量表信息完全不存在于公开网络
- 用户需要即时版权授权（需联系版权方）

## INPUTS

### REQUIRED
- 量表名称（中文或英文，如 "SGRQ" / "圣乔治呼吸问卷"）

### OPTIONAL
- 指定版本（如 "最新版本" 或 "v2.0"）
- 指定检索重点（如 "重点检索 CDISC 映射"）
- 更新模式（如 "增量更新已有文档"）

### EXAMPLES
- "检索 SGRQ 量表的信息"
- "整理 EORTC QLQ-C30 量表的完整报告"
- "查询 PHQ-9 量表的 CDISC domain 和统计方法"
- "更新 EASI 量表的版本历史"

## OUTPUTS

### 默认输出
- 飞书云文档链接（标准化报告）
- 知识库归档确认

### 文档结构
```markdown
# [量表名称] 标准化研究报告

## 一、量表简介
### 1.1 背景及发展历程
### 1.2 应用领域
### 1.3 量表内容
### 1.4 版本历史（最新 + 更新摘要）
### 1.5 官方量表全文 ⚠️（必须有 PDF 链接或截图）

## 二、版权与授权信息
### 2.1 版权方信息
### 2.2 中文版信息

## 三、CDISC 编程
### 3.1 标准 aCRF 与受控术语（自动推荐 Domain）
### 3.2 SDTM 实现
### 3.3 ADaM 实现

## 四、统计分析
### 4.1 数据类型与分布特征
### 4.2 缺失值处理（条目级 + 访视级）
### 4.3 常规分析模型（含 SAS/R 程序）
### 4.4 探索性分析
### 4.5 结果呈现（Table/Figure 模板）

## 五、参考文献
```

### 1.5 官方量表全文章节模板
```markdown
### 1.5 官方量表全文

**获取状态**：✅ 已下载 PDF / ✅ 已截图

**PDF 下载**：
- 下载链接：[量表名称 Official PDF](URL)
- 本地路径：`/Users/wangyafei/Downloads/scales/[量表名]_official.pdf`
- 文件大小：XX KB

**量表条目预览**：
（如为截图，此处插入图片）

| 部分 | 条目示例 | 评分方式 |
|------|---------|---------|
| ... | ... | ... |

> **注意**：完整量表请下载上方 PDF 文件。量表版权归 [版权方] 所有，仅限学术研究使用。
```

## WORKFLOW

### 1. 解析量表名称
- 提取关键词（中英文全称、缩写）
- 识别同义词（如 "SGRQ" = "圣乔治呼吸问卷" = "St George's Respiratory Questionnaire"）

### 2. 并行检索 7 个维度 + 量表全文获取
使用 `browser` 工具打开多个 Tab 并行检索：

| 维度 | 数据源 | 检索策略 |
|------|--------|---------|
| 背景信息 | PubMed, Google Scholar, 量表官网 | `"[量表名] development validation history"` |
| **官方量表全文** | 官网 PDF 下载链接 | `"[量表名] official instrument PDF download"` |
| 版本历史 | 官网，GitHub, 修订记录 | `"[量表名] version history revision changelog"` |
| 版权信息 | Mapi Research Trust, 版权方官网 | `"[量表名] copyright license permission"` |
| 中文版信息 | CNKI, 万方，中文论文 | `"[量表名] 中文版 信效度 验证"` |
| CDISC 映射 | CDISC 官网，TAUGs, SDTMIG | `"[量表名/概念] CDISC SDTM ADaM domain"` |
| 统计方法 | 高引文献，系统评价 | `"[量表名] scoring algorithm missing data analysis"` |

### 2.1 ⚠️ 量表全文获取（强制要求）

**必须完成以下任一操作，否则停止执行并告知用户**：

#### 选项 A：下载官方 PDF（优先）
```
1. 在官网/权威来源查找 PDF 下载链接
2. 使用 exec 下载：curl -L -o "/Users/wangyafei/Downloads/scales/[量表名]_official.pdf" "[PDF_URL]"
3. 验证文件：ls -lh 确认文件存在且>1KB
4. 在文档 1.4 章节后插入"官方量表全文"章节，包含：
   - PDF 下载链接（可点击）
   - 本地保存路径
   - 文件大小
   - 版权说明
```

#### 选项 B：屏幕截图（无法下载时）
```
1. 打开量表官方页面（browser.open）
2. 使用 browser.snapshot 捕获页面（aria refs）
3. 如页面较长 → 滚动分多次截图（至少覆盖完整量表条目）
4. 使用 feishu_doc.upload_image 上传图片到飞书云盘
5. 在文档 1.4 章节后插入"官方量表全文"章节，包含：
   - 量表条目截图（至少 1 张）
   - 来源网址链接
   - 版权说明
```

#### ❌ 无法获取时的处理
```
如无法找到 PDF 且无法截图：
1. 停止执行
2. 告知用户："未找到 [量表名] 的官方量表全文（PDF 或截图）"
3. 提供版权方联系方式
4. 询问用户是否继续生成报告（不含量表全文）
```

### 2.2 量表全文检索策略

**检索关键词**（按顺序尝试）：
```
1. "[量表名] official PDF download"
2. "[量表名] full instrument PDF"
3. "[量表名] questionnaire PDF"
4. "[量表名] 官网" → 查找下载链接
5. "[量表名] Mapi Research Trust" → 版权方官网
```

**权威来源优先级**：
```
1. 量表官方网站（.edu/.org 域名）
2. 版权方官网（如 Mapi Research Trust）
3. 原作者机构网站
4. 指南/共识文件（如 EPOS2020）
5. 学术论文补充材料（Supplementary Materials）
```

### 3. 信息提取与结构化
- 使用 `web_fetch` 提取页面内容
- 过滤噪声，提取关键字段
- 验证信息一致性（多源交叉验证）

### 4. CDISC 自动推荐
基于规则引擎推荐 Domain：

```json
{
  "生活质量/HRQoL": {"sdtm": "QS", "adam": "ADQS"},
  "症状评估": {"sdtm": "QS", "adam": "ADQS"},
  "病史": {"sdtm": "MH", "adam": "ADMH"},
  "合并用药": {"sdtm": "CM", "adam": "ADCM"},
  "不良事件": {"sdtm": "AE", "adam": "ADAE"},
  "生命体征": {"sdtm": "VS", "adam": "ADVS"},
  "实验室检查": {"sdtm": "LB", "adam": "ADLB"}
}
```

### 5. 生成飞书文档（重要！）

**⚠️ 内容长度限制**：飞书 API 对单次写入内容长度有限制（约 5KB）

**推荐方法**：
```
IF 内容 > 5KB:
  1. 先 create 创建空文档
  2. 将内容按章节分割（每段<4KB）
  3. 使用 insert 操作逐段插入（after_block_id）
  4. 每插入一段后获取新的 block_id
ELSE:
  直接使用 write 操作一次性写入
```

**操作步骤**：
1. **创建文档**：`feishu_doc create` → 获取 doc_token
2. **写入第一章**：`feishu_doc write` → 写入完整第一章
3. **获取最后 block_id**：`feishu_doc list_blocks` → 获取最后一个 block_id
4. **插入后续章节**：`feishu_doc insert` + after_block_id → 逐章插入
5. **验证内容**：`feishu_doc read` → 确认内容完整

**内容分割策略**：
```
章节 1：一、量表简介（约 3KB）
章节 2：二、版权与授权信息（约 2KB）
章节 3：三、CDISC 编程（约 3KB）
章节 4：四、统计分析（约 4KB）
章节 5：五、参考文献 + 附录（约 2KB）
```

### 6. 保存到知识库
- 使用 `feishu_wiki` 创建/更新节点
- 按疾病领域/量表类型分类
- 记录版本历史

### 7. 增量更新（可选）
- 对比新旧版本
- 高亮变更内容
- 更新版本历史

## SAFETY & EDGE CASES

- **版权信息**：明确标注信息来源，不提供法律建议
- **版本准确性**：优先使用最新版本，标注检索日期
- **CDISC 推荐**：标注为"推荐"，需人工确认
- **付费内容**：只能获取摘要，标注"需订阅"
- **多版本并存**：明确标注各版本差异
- **信息冲突**：多源交叉验证，标注不确定性
- **⚠️ 飞书文档长度限制**：
  - 单次写入内容 < 5KB
  - 长文档需分章节插入
  - 使用 insert + after_block_id 逐段写入
- **⚠️ 量表全文获取（强制）**：
  - 必须下载 PDF 或截图，否则停止执行
  - PDF 文件需验证存在且>1KB
  - 截图需覆盖完整量表条目

## STOP AND ASK THE USER IF

- 量表名称模糊/有多个同名量表
- 版权信息无法确认（需用户核实）
- CDISC 推荐置信度低（需人工判断）
- 检索结果为空（需调整策略）
- 知识库权限不足（需用户授权）
- **⚠️ 无法获取量表全文（PDF/截图）**：
  - 停止执行并告知用户
  - 提供已尝试的检索来源
  - 提供版权方联系方式
  - 询问是否继续生成报告（不含量表全文）

## EXAMPLES

### Example 1: 首次检索
**Input**: "检索 SGRQ 量表的信息"

**Process**:
1. 解析 → SGRQ = St George's Respiratory Questionnaire = 圣乔治呼吸问卷
2. 并行检索 7 个维度
3. 提取结构化数据
4. CDISC 推荐 → QS (生活质量)
5. 生成飞书文档
6. 保存到知识库

**Output**:
```
✅ 已完成 SGRQ 量表信息检索

📄 文档链接：https://xxx.feishu.cn/docx/xxxxx
📚 已归档至：医学量表库 > 呼吸系统 > SGRQ

检索维度：
✓ 背景信息（5 篇文献）
✓ 官方量表（✅ 已下载 PDF - 7.0KB）
✓ 版本历史（v2.1 最新版，2023 更新）
✓ 版权信息（Mapi Research Trust）
✓ 中文版（3 篇验证文献）
✓ CDISC 映射（QS/ADQS 推荐）
✓ 统计方法（4 种模型）

📎 量表全文：
- PDF 路径：/Users/wangyafei/Downloads/scales/SGRQ_official.pdf
- 下载链接：[SGRQ Official PDF](https://xxx.xxx.ac.uk/xxx.pdf)
```

### Example 2: 增量更新
**Input**: "更新 EASI 量表的版本信息"

**Process**:
1. 读取已有文档
2. 检索最新版本信息
3. 对比变更内容
4. 更新版本历史章节
5. 标注变更日期

**Output**:
```
✅ 已更新 EASI 量表版本信息

📝 新增内容：
- v2024 版本（2024-01 发布）
- 儿童权重系数调整
- 新增深色皮肤红斑评估指南

📄 更新链接：https://xxx.feishu.cn/docx/xxxxx
```

## FILES

- `templates/scale-report.md` - 文档模板
- `rules/cdisc-mapping.json` - CDISC 推荐规则
- `examples/SGRQ-example.md` - 示例输出

## RELATED SKILLS

- `lark-doc` - 飞书文档操作
- `lark-wiki` - 飞书知识库管理
- `agent-browser` - 浏览器自动化