# medical-scale-research

Adopt this skill: https://proskills.md/skills/other/kevinget-svg-medical-scale-research

Page: https://proskills.md/skills/other/kevinget-svg-medical-scale-research
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: SKILL.md
size: 10510
upstream: https://github.com/kevinget-svg/medical-scale-research/blob/HEAD/SKILL.md

````text
---
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` - 浏览器自动化
````

## File: README.md
upstream: https://github.com/kevinget-svg/medical-scale-research/blob/HEAD/README.md

````text
# 医学量表检索技能 (medical-scale-research)

[![OpenClaw Skill](https://img.shields.io/badge/OpenClaw-Skill-blue)](https://openclaw.ai)
[![ClawHub](https://img.shields.io/badge/ClawHub-Published-green)](https://clawhub.ai)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![GitHub stars](https://img.shields.io/github/stars/kevinget-svg/medical-scale-research?style=social)](https://github.com/kevinget-svg/medical-scale-research)

> 🤖 自动检索医学量表信息，生成标准化研究报告的 AI 助手

---

## 📖 简介

**医学量表检索技能**是一个专为临床研究人员、生物统计师和医药行业从业者设计的 OpenClaw 技能。它能够自动检索医学量表的完整信息（背景、版权、CDISC 映射、统计方法等），下载量表官方 PDF 或截图，并生成标准化的飞书云文档报告。

### 🎯 适用人群
- 🏥 临床研究人员
- 📊 生物统计师
- 💊 医药企业研发人员
- 🎓 医学研究生
- 📚 系统评价/Meta 分析研究者

---

## ✨ 核心功能

| 功能 | 说明 |
|------|------|
| 🔍 **7 维度并行检索** | 背景信息、版本历史、版权信息、中文版、CDISC 映射、统计方法、量表全文 |
| 📄 **量表全文获取** | 自动下载官方 PDF 或屏幕截图，强制要求，确保完整性 |
| 🎯 **CDISC 自动推荐** | 基于规则引擎自动推荐 SDTM/ADaM Domain（High 置信度） |
| 📊 **标准化报告** | 生成 5 章结构报告（量表简介/版权/CDISC/统计/参考文献） |
| 💾 **飞书集成** | 自动创建飞书云文档，支持知识库归档 |
| 📝 **代码示例** | 含完整 SAS/R 代码（缺失处理、MMRM、应答率分析等） |

---

## 🚀 快速开始

### 前置要求

- ✅ OpenClaw 运行环境
- ✅ 飞书 API 权限（用于文档生成）
- ✅ 浏览器自动化权限（用于信息检索）

### 安装方式

#### 方式 1：通过 ClawHub 安装（推荐）
```bash
openclaw skill install medical-scale-research
```

#### 方式 2：手动安装
```bash
# 1. 克隆或下载本仓库
git clone https://github.com/kevinget-svg/medical-scale-research.git

# 2. 复制到 OpenClaw 技能目录
cp -r medical-scale-research ~/.openclaw/workspace/skills/

# 3. 验证安装
openclaw skill list | grep medical-scale
```

### 使用示例

在 OpenClaw 对话中输入以下指令：

```
# 基础检索
"检索 SGRQ 量表的信息"
"整理 TNSS 量表的完整报告"

# 查询特定信息
"查询 PASI量表的 CDISC domain"
"PASI量表的统计分析方法是什么"

# 更新已有报告
"更新 EASI量表的版本信息"
```

### 输出示例

**技能会生成如下报告**：

```
✅ 已完成 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)
```

---

## 📋 报告结构

生成的标准化报告包含以下章节：

```
一、量表简介
  ├─ 1.1 背景及发展历程
  ├─ 1.2 版本历史
  ├─ 1.3 应用领域
  ├─ 1.4 量表内容
  └─ 1.5 官方量表全文 ⚠️（PDF 链接或截图）

二、版权与授权信息
  ├─ 2.1 版权方信息
  └─ 2.2 中文版信息

三、CDISC 编程
  ├─ 3.1 标准 aCRF 与受控术语
  ├─ 3.2 SDTM 实现
  └─ 3.3 ADaM 实现

四、统计分析
  ├─ 4.1 数据类型与分布特征
  ├─ 4.2 缺失值处理（含 SAS/R 代码）
  ├─ 4.3 常规分析模型
  ├─ 4.4 探索性分析
  └─ 4.5 结果呈现（Table/Figure 模板）

五、参考文献

附录
  ├─ A. 检索策略记录
  └─ B. 量表全文获取记录
```

---

## 📦 发布指南

### 发布到 ClawHub（手动）

目前 ClawHub 不支持 CLI 直接发布，需要手动操作：

1. **访问 ClawHub 官网**
   - 打开 https://clawhub.ai
   - 登录你的 GitHub 账号

2. **创建技能包**
   ```bash
   # 打包技能目录
   cd ~/.openclaw/workspace/skills/
   tar -czf medical-scale-research.tar.gz medical-scale-research/
   ```

3. **上传技能**
   - 进入 "Submit Skill" 页面
   - 填写技能信息：
     - 名称：医学量表检索技能
     - 描述：自动检索医学量表信息，生成标准化研究报告
     - 分类：Healthcare / Research Tools
     - 标签：medical, scale, CDISC, feishu, clinical-trials
   - 上传 `medical-scale-research.tar.gz`
   - 提交审核

4. **等待审核**
   - ClawHub 团队会在 1-3 个工作日内审核
   - 审核通过后会出现在技能市场

---

## 🔧 配置说明

### 文件保存路径

量表 PDF 文件默认保存到：
```
/Users/wangyafei/Downloads/scales/[量表名]_official.pdf
```

可在 `SKILL.md` 中修改保存路径。

### 飞书权限配置

1. 打开飞书开发者后台
2. 创建应用 → 添加权限：
   - 云文档读写权限
   - 知识库管理权限
3. 将应用添加到工作群

### CDISC 规则配置

CDISC Domain 推荐规则位于：
```
rules/cdisc-mapping.json
```

可根据需要添加新的映射规则。

---

## 📚 已支持量表示例

| 量表名称 | 英文全称 | 疾病领域 | 状态 |
|---------|---------|---------|------|
| SGRQ | St George's Respiratory Questionnaire | 呼吸系统 | ✅ 已测试 |
| TNSS | Total Nasal Symptom Score | 耳鼻喉科 | ✅ 已测试 |
| PASI | Psoriasis Area and Severity Index | 皮肤科 | ✅ 已测试 |
| EASI | Eczema Area and Severity Index | 皮肤科 | ✅ 已测试 |
| EORTC QLQ-C30 | European Organisation for Research and Treatment of Cancer Quality of Life Questionnaire | 肿瘤科 | 🔄 待测试 |
| PHQ-9 | Patient Health Questionnaire-9 | 精神科 | 🔄 待测试 |

---

## 🛠️ 技能文件结构

```
medical-scale-research/
├── SKILL.md                      # 技能说明和执行指令
├── templates/
│   └── scale-report.md           # 文档模板（含 1.5 官方量表全文）
├── rules/
│   └── cdisc-mapping.json        # CDISC 推荐规则（12 条映射）
├── examples/
│   └── SGRQ-example.md           # SGRQ 量表示例输出
├── README.md                     # 本文件
└── LICENSE                       # MIT 许可证
```

---

## 🤝 贡献指南

欢迎提交 Issue 和 Pull Request！

### 如何贡献

1. Fork 本仓库
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启 Pull Request

### 报告问题

如遇到以下问题，请提交 Issue：
- 🐛 技能执行错误
- 📝 文档内容错误
- 💡 功能改进建议
- 🔍 新量表检索请求

---

## 📝 更新日志

### v1.0.0 (2026-04-19)
- ✨ 初始版本发布
- 🔍 7 维度并行检索
- 📄 强制量表全文获取（PDF/截图）
- 🎯 CDISC Domain 自动推荐
- 📊 标准化报告生成
- 💾 飞书文档集成
- 📝 SAS/R 代码示例

---

## 📄 许可证

本项目采用 **MIT 许可证**。详见 [LICENSE](LICENSE) 文件。

---

## 📧 联系方式

- 📮 Issue: [GitHub Issues](https://github.com/kevinget-svg/medical-scale-research/issues)
- 💬 讨论：OpenClaw 社区
- 📧 邮件：justingwang0726@gmail.com

---

## 🙏 致谢

感谢以下项目提供的数据源：
- [CDISC](https://www.cdisc.org/) - 临床数据交换标准
- [Mapi Research Trust](https://eprovide.mapi-trust.org/) - 量表版权信息
- [PubMed](https://pubmed.ncbi.nlm.nih.gov/) - 医学文献数据库
- [OpenClaw](https://openclaw.ai) - AI 自动化框架

---

## ⭐ 支持项目

如果觉得这个技能有用，欢迎：
1. 给仓库点个 ⭐ Star
2. 分享给需要的同事/朋友
3. 提交 Issue 或 Pull Request

---

*最后更新：2026-04-19*
*维护者：王亚飞 (Kevin Wang)*
````