dvcrn CDISC Library API Skill - 临床数据标准查询
查询 CDISC Library API，获取 QRS 量表、ADaM、CDASH、SDTM、受控术语等临床数据标准。
🔐 配置
在 TOOLS.md 中添加 API Key：
## CDISC API
- **API Key**: `你的 API Key`
获取地址：https://api.developer.library.cdisc.org/profile
或在环境变量中设置 CDISC_API_KEY。
📋 命令
基础查询
| 命令 | 说明 | 示例 |
|---|---|---|
/cdisc-library-api products |
列出所有产品类别 | /cdisc-library-api products |
/cdisc-library-api qrs <code> [version] |
查询 QRS 量表 | /cdisc-library-api qrs AIMS01 |
/cdisc-library-api items <code> <version> |
查询量表项目列表 | /cdisc-library-api items AIMS01 2-0 |
/cdisc-library-api adam <product> [ds] |
查询 ADaM 产品/数据结构 | /cdisc-library-api adam adam-2-1 |
/cdisc-library-api sdtm <version> [domain] |
查询 SDTM 实施指南 | /cdisc-library-api sdtm 3-4 DM |
/cdisc-library-api cdash <version> [domain] |
查询 CDASH 标准 | /cdisc-library-api cdash 1-0 DM |
/cdisc-library-api ct <codelist> |
查询受控术语代码表 | /cdisc-library-api ct C102111 |
/cdisc-library-api ct-packages |
查询术语包列表 | /cdisc-library-api ct-packages |
高级查询
| 命令 | 说明 | 示例 |
|---|---|---|
/cdisc-library-api root <type> |
查询版本无关根资源 | /cdisc-library-api root qrs |
/cdisc-library-api docs [category] |
查询 CDISC 文档 | /cdisc-library-api docs |
/cdisc-library-api rules [product] |
查询 CDISC 规则 | /cdisc-library-api rules adam |
/cdisc-library-api search <keyword> |
搜索变量/域/量表 | /cdisc-library-api search USUBJID |
/cdisc-library-api compare <type> <id> <v1> <v2> |
版本比较 | /cdisc-library-api compare qrs AIMS01 1-0 2-0 |
工具命令
| 命令 | 说明 | 示例 |
|---|---|---|
/cdisc-library-api export <type> <id> [v] |
导出数据为 JSON/CSV | /cdisc-library-api export items AIMS01 2-0 --format=csv |
/cdisc-library-api batch <file> |
批量查询 | /cdisc-library-api batch queries.txt |
/cdisc-library-api cache clear |
清除缓存 | /cdisc-library-api cache clear |
📦 文件结构
skills/cdisc/
├── SKILL.md # 本文件
├── README.md # 快速开始指南
├── cdisc_client.py # API 客户端封装
├── commands/
│ ├── products.py # 产品列表
│ ├── qrs.py # QRS 量表查询
│ ├── items.py # 量表项目查询
│ ├── adam.py # ADaM 查询
│ ├── sdtm.py # SDTM 查询
│ ├── cdash.py # CDASH 查询
│ ├── ct.py # 受控术语查询
│ ├── ct_packages.py # 术语包列表
│ ├── root.py # 根资源查询
│ ├── docs.py # 文档查询
│ ├── rules.py # 规则查询
│ ├── search.py # 搜索
│ ├── compare.py # 版本比较
│ ├── export.py # 导出功能
│ └── batch.py # 批量查询
└── assets/
└── quickref.md # 速查表
🔧 使用示例
查询量表详情
/cdisc-library-api qrs AIMS01
输出：
- 量表名称、类型、注册状态
- 最新版本号
- 项目数量
- 前 5 个项目预览
查询量表完整项目
/cdisc-library-api items AIMS01 2-0
输出所有项目列表（序号、代码、标签）。
查询 ADaM 数据结构
/cdisc-library-api adam adam-2-1 ADSL
输出 ADSL 数据结构的所有变量集。
查询 SDTM 域变量
/cdisc-library-api sdtm 3-4 DM
输出 DM 域的所有变量，按角色分组（标识符、时间戳、记录标识等）。
查询受控术语
/cdisc-library-api ct C102111
输出代码列表详情和前 20 个术语。
搜索
/cdisc-library-api search USUBJID
跨所有产品类别搜索匹配项。
版本比较
/cdisc-library-api compare qrs AIMS01 1-0 2-0
输出两个版本之间的新增、删除、修改项。
导出为 CSV
/cdisc-library-api export items AIMS01 2-0 --format=csv
导出量表项目到 CSV 文件。
批量查询
创建 queries.txt:
qrs AIMS01
qrs CGI01 1-0
items AIMS01 2-0
adam adam-2-1
ct C102111
执行：
/cdisc-library-api batch queries.txt
⚠️ 注意事项
- 速率限制：自动添加 100ms 请求间隔
- 缓存：查询结果缓存 1 小时，位于
skills/cdisc/.cache/ - 错误处理：
- 401：检查 API Key 是否正确
- 404：检查参数格式（版本号应为
x-y格式） - 429：请求过于频繁，已自动限流
- 版本号格式：使用
x-y格式（如2-0），不是x.y
🔗 相关资源
Skill 版本：1.0 | 基于 CDISC Library API v1 | 覆盖 9 大类 350+ 端点