用途
ClinVar 是 NCBI 提供的免费公开数据库，收录人类遗传变异与表型之间关系及其支持证据的报告。本技能用于在需要检索、解读或批量处理 ClinVar 数据时提供指导，包括：按基因、疾病或临床意义搜索变异；解读临床意义分类（致病、良性、VUS 等）；通过 E-utilities API 以编程方式访问数据；从 FTP 下载并处理批量数据；理解审查状态与星级评定；处理冲突的变异解读；为变异调用集添加临床意义注释。
主要能力
1. 搜索与查询 ClinVar
可通过网页界面 https://www.ncbi.nlm.nih.gov/clinvar/ 进行搜索，常见模式包括：按基因（BRCA1[gene]）、按临床意义（pathogenic[CLNSIG]）、按疾病（breast cancer[disorder]）、按变异名称、按染色体，以及组合查询（BRCA1[gene] AND pathogenic[CLNSIG]）。
也可通过 NCBI E-utilities API 编程访问，包括 esearch（搜索）、esummary（摘要）、efetch（下载完整 XML 记录）、elink（关联其他 NCBI 数据库）。示例：
curl "https://eutils.ncbi.nlm.nih.gov/entrez/eutils/esearch.fcgi?db=clinvar&term=BRCA1[gene]+AND+pathogenic[CLNSIG]&retmode=json"
最佳实践：先在网页界面测试查询再自动化；使用 API key 将速率限制从 3 次/秒提升到 10 次/秒；对速率限制错误实现指数退避；使用 Biopython 时设置 Entrez.email。
2. 解读临床意义
ClinVar 使用标准化术语。主要胚系分类（ACMG/AMP）包括：致病（P，约 99% 概率致病）、可能致病（LP，约 90%）、意义未明（VUS，证据不足）、可能良性（LB）、良性（B）。
审查状态（星级）：★★★★ 实践指南（最高置信度）；★★★ 专家小组审查（如 ClinGen，高置信度）；★★ 多个提交者且无冲突（中等置信度）；★ 单个提交者附标准（标准权重）；☆ 无断言标准（低置信度）。
关键注意事项：始终检查审查状态，优先 ★★★ 或 ★★★★；冲突解读需人工评估；分类可能随新证据变化；VUS 变异缺乏足够证据用于临床。
3. 从 FTP 下载批量数据
FTP 地址：ftp://ftp.ncbi.nlm.nih.gov/pub/clinvar/。更新计划：每月发布（每月第一个周四，完整数据集并归档）；每周更新（每周一，增量更新）。
可用格式：XML（最全面，含 VCV 变异文件和 RCV 记录文件，包含完整提交详情与证据）；VCF（用于基因组流程，分 GRCh37 和 GRCh38，但不含大于 10kb 的变异和复杂结构变异）；制表符分隔文件（variant_summary.txt.gz、var_citations.txt.gz、cross_references.txt.gz）。
示例下载：
wget ftp://ftp.ncbi.nlm.nih.gov/pub/clinvar/xml/clinvar_variation/ClinVarVariationRelease_00-latest.xml.gz wget ftp://ftp.ncbi.nlm.nih.gov/pub/clinvar/vcf_GRCh38/clinvar.vcf.gz
4. 处理与分析数据
XML 文件可用 Python 的 xml.etree 迭代解析，提取变异 ID、临床意义、审查状态等。VCF 文件可用 bcftools 过滤或注释，例如：
bcftools view -i 'INFO/CLNSIG~"Pathogenic"' clinvar.vcf.gz bcftools annotate -a clinvar.vcf.gz -c INFO your_variants.vcf
也可用 PyVCF 或 pandas 处理制表符分隔文件，例如按基因和临床意义筛选、统计分类分布。命令行工具如 zcat、awk、cut 也可用于快速筛选。
5. 处理冲突解读
当多个提交者对同一变异给出不同分类时，ClinVar 报告“冲突解读”。解决策略：检查审查状态（星级越高权重越大）；审查各提交者的证据和断言标准；考虑提交日期（较新提交可能反映更新证据）；参考人群频率数据（如 gnomAD）；参考专家小组分类（★★★）。临床使用应始终咨询遗传学专业人员。排除冲突的查询示例：TP53[gene] AND pathogenic[CLNSIG] NOT conflicting[RVSTAT]。
6. 跟踪分类更新
分类可能因新功能研究、人群频率更新、ACMG/AMP 指南修订、家系分离数据等而变化。最佳实践：记录 ClinVar 版本和访问日期以保证可复现；定期复查关键变异；订阅 ClinVar 邮件列表；使用每月归档版本获得稳定数据集。
7. 向 ClinVar 提交数据
机构可提交变异解读。提交方式：网页提交门户 https://submit.ncbi.nlm.nih.gov/subs/clinvar/；API 提交（需服务账户）；通过 Excel 模板批量提交。要求：NCBI 机构账户、断言标准（最好 ACMG/AMP）、支持证据。联系 clinvar@ncbi.nlm.nih.gov 设置提交账户。
使用方式
本技能提供参考文档：references/api_reference.md（E-utilities API 完整文档，含速率限制、认证和 Python/Biopython 示例）、references/clinical_significance.md（临床意义分类、星级、冲突解决指南）、references/data_formats.md（XML、VCF、制表符格式及 FTP 目录结构）。外部资源包括 ClinVar 主页、文档、E-utilities 文档、ACMG 指南（Richards et al., 2015, PMID: 25741868）、ClinGen 专家小组。
适用场景
适用于临床遗传学与研究中检索变异、解读致病性、批量注释变异调用集、构建本地数据库、分析特定疾病相关变异等。
限制
数据质量方面：并非所有提交权重相同，需检查星级；存在冲突解读需人工评估；历史提交可能过时；VUS 不是临床诊断。范围方面：不用于直接临床诊断，需遗传学专业人员参与；变异频率因血统而异；覆盖不完整；需协调基因组版本（GRCh37/GRCh38）。技术方面：VCF 不含大于 10kb 的变异；API 速率限制（无 key 3 次/秒，有 key 10 次/秒）；完整 XML 发布为多 GB 压缩文件；无实时更新（网站每周更新，FTP 每月/每周）。