Use when the user needs academic citations, BibTeX, venue/author quality checks, or help filling [CITE] placeholders. Triggers include 文献引用、找引用、citation、bib、参考文献、替换不规范引用、查询作者 H-index、判断期刊/会议质量。
scripts/ 目录中的脚本执行,禁止手动编写 curl 命令依赖:curl、jq、sqlite3
| 脚本 | 用途 | 用法 |
|---|---|---|
s2_search.sh | 少量高相关结果检索(含 arXiv 判断) | bash scripts/s2_search.sh "query" [limit] |
s2_bulk_search.sh | 批量拉取候选结果并按本地 limit 输出(含 arXiv 判断) | bash scripts/s2_bulk_search.sh "query" "year_range" limit |
author_info.sh | 作者信息查询(H-index) |
bash scripts/author_info.sh "author_id" |
venue_info.sh | 期刊综合查询 | bash scripts/venue_info.sh "venue_name" |
ccf_lookup.sh | CCF 分级查询 | bash scripts/ccf_lookup.sh "venue_name" |
if_lookup.sh | 影响因子查询 | bash scripts/if_lookup.sh "journal_name" |
doi2bibtex.sh | DOI 转 BibTeX | bash scripts/doi2bibtex.sh "doi" |
crossref_search.sh | CrossRef 搜索(fallback) | bash scripts/crossref_search.sh "query" [limit] |
搜索结果会自动标记 arXiv 文章的引用状态:
| 状态 | 条件 | 推荐建议 |
|---|---|---|
recommended | arXiv + 引用 ≥ 100 | ✅ 高影响力 arXiv,可引用 |
caution | arXiv + 引用 < 100 | ⚠️ 低引用 arXiv,谨慎引用 |
normal | 正式发表 | ✅ 正式发表 |
配置引用阈值(默认 100):
export ARXIV_CITATION_THRESHOLD=100
搜索结果包含前 3 位作者的 ID,可用于查询 H-index:
# 查询作者 H-index、总引用量、论文数
bash "${CLAUDE_SKILL_ROOT}/scripts/author_info.sh" "18119920"
返回示例:
{
"name": "Daquan Zhou",
"hIndex": 25,
"citations": 8500,
"papers": 42
}
识别用户需求类型:
| 引用目的 | 查询策略示例 |
|---|---|
| 事实背书 | "chest radiography most widely used imaging test globally statistics" |
| 方法引用 | "attention mechanism transformer neural machine translation" |
| 背景介绍 | "deep learning medical image analysis survey review" |
s2_search.shs2_bulk_search.sh# 少量高相关结果
bash "${CLAUDE_SKILL_ROOT}/scripts/s2_search.sh" "YOUR_QUERY" 10
# 批量候选结果(bulk endpoint),再由脚本按 limit 输出前 N 条
bash "${CLAUDE_SKILL_ROOT}/scripts/s2_bulk_search.sh" "YOUR_QUERY" "2020-" 20
如果返回 429 错误,使用 CrossRef fallback:
bash "${CLAUDE_SKILL_ROOT}/scripts/crossref_search.sh" "YOUR_QUERY" 20
# 查询期刊质量
bash "${CLAUDE_SKILL_ROOT}/scripts/venue_info.sh" "Nature Medicine"
# 查询作者 H-index
bash "${CLAUDE_SKILL_ROOT}/scripts/author_info.sh" "AUTHOR_ID"
bash "${CLAUDE_SKILL_ROOT}/scripts/doi2bibtex.sh" "10.1038/s41591-020-0792-9"
输出格式示例:
## 引用推荐报告
### [CITE] 位置 1
**原文上下文**:
> In chest radiography---arguably the most widely used imaging test globally [CITE]---
**推荐文献**:
#### 推荐 1: Wu2020 - CheXpert: A large chest radiograph dataset...
**质量指标**:
| 维度 | 值 | 说明 |
|------|-----|------|
| CCF 分级 | N/A | 非CS领域期刊 |
| JCR 分区 | Q1 | 顶级医学影像期刊 |
| 影响因子 | 29.1 | 极高影响力 |
| 引用量 | 3500+ | 高被引文献 |
| arXiv 状态 | normal | 正式发表 |
**推荐理由**:顶级期刊发表,直接支持原文论点。
**BibTeX**:
```bibtex
@article{Wu2020, ... }
建议用法:将 [CITE] 替换为 ~\cite{Wu2020}
---
## ⚙️ 配置
### Semantic Scholar API Key(强烈推荐)
```bash
# 在 Skill 目录创建 .env 文件
echo 'S2_API_KEY="your_key_here"' > "${CLAUDE_SKILL_ROOT}/.env"
# 获取 API Key: https://www.semanticscholar.org/product/api/api-key
| 模式 | 速率限制 | 推荐场景 |
|---|---|---|
| 有 API Key | 1 次/秒 | 日常使用(推荐) |
| 无 API Key | 共享限额 | 极易触发 429 |
# 默认 100,可在 .env 中配置
echo 'ARXIV_CITATION_THRESHOLD=100' >> "${CLAUDE_SKILL_ROOT}/.env"
s2_bulk_search.shcrossref_search.sh(无严格限制)| 维度 | 权重 | 计算 |
|---|---|---|
| CCF 分级 | 基础分 | A=100, B=70, C=40 |
| JCR 分区 | 基础分 | Q1=80, Q2=60, Q3=40, Q4=20 |
| 中科院分区 | 基础分 | 1区=90, 2区=70, 3区=50, 4区=30 |
| 影响因子 | 30% | IF × 5 (上限50) |
| 引用量 | 20% | log₁₀(citations+1) × 10 (上限50) |
| 年份 | 10% | (year-2015) × 2 (上限30) |
| 作者 H-index | 10% | 第一作者 H-index × 2 (上限30) |
arXiv 处理: