医学量表检索技能
by @kevinget-svg
医学量表信息检索与标准化报告生成。通过浏览器自动化检索量表背景、版权、CDISC 映射、统计方法等信息，生成飞书云文档并保存到量表知识库。
clawhub install medical-scale-research📖 About This Skill
name: medical-scale-research description: 医学量表信息检索与标准化报告生成。通过浏览器自动化检索量表背景、版权、CDISC 映射、统计方法等信息，生成飞书云文档并保存到量表知识库。
医学量表 Skill - medical-scale-research
PURPOSE
通过浏览器自动化检索医学量表的完整信息（背景、版权、CDISC 映射、统计方法等），生成标准化的飞书云文档，并保存到量表知识库。支持版本追踪和增量更新。
WHEN TO USE
TRIGGERS
DO NOT USE WHEN
INPUTS
REQUIRED
OPTIONAL
EXAMPLES
OUTPUTS
默认输出
文档结构
# [量表名称] 标准化研究报告一、量表简介
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 官方量表全文章节模板
### 1.5 官方量表全文获取状态：✅ 已下载 PDF / ✅ 已截图
PDF 下载：
下载链接：量表名称 Official PDF
本地路径：/Users/wangyafei/Downloads/scales/[量表名]_official.pdf
文件大小：XX KB 量表条目预览：
（如为截图，此处插入图片）
| 部分 | 条目示例 | 评分方式 |
|------|---------|---------|
| ... | ... | ... |
> 注意：完整量表请下载上方 PDF 文件。量表版权归 [版权方] 所有，仅限学术研究使用。
WORKFLOW
1. 解析量表名称
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：{
"生活质量/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
STOP AND ASK THE USER IF
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
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 - 浏览器自动化