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

⚠️ 注意事项

1. 速率限制：自动添加 100ms 请求间隔
2. 缓存：查询结果缓存 1 小时，位于 skills/cdisc/.cache/
3. 错误处理：
4. 401：检查 API Key 是否正确
5. 404：检查参数格式（版本号应为 x-y 格式）
6. 429：请求过于频繁，已自动限流
7. 版本号格式：使用 x-y 格式（如 2-0），不是 x.y

🔗 相关资源

• CDISC Library Browser
• API Portal
• 速查表
• 完整 API 文档

---

Skill 版本：1.0 | 基于 CDISC Library API v1 | 覆盖 9 大类 350+ 端点