前言¶
写综述或开题时，常见做法是手动在数据库里换关键词、抄元数据、再整理引用链。把 Agent 接到学术检索上，如果缺少固定流程，容易只返回几篇「看起来像」的论文，摘要和 DOI 也对不齐。
下面介绍的「万方检索skill」在 SkillHub 上的定位，是按主题、作者或 DOI 查论文、拉结构化元数据、沿引用链扩展，并支持自动文献综述。简介写明数据来自 OpenAlex API（免费、无需 API Key），与万方数据商业库不是同一套接口；名称里的「万方」容易让人误解，使用前建议先看官方页上的简介。
撰稿时曾用 SkillHub 公开 API 核对：https://api.skillhub.cn/user_caed61ea/slug1234567 当前无法解析到可下载的技能条目（页面抓取亦未成功）。下文能力与命令来自与官方简介一致的通用 SKILL.md 结构（与同描述的开源学术检索 Skill 核对一致）；社区评分、分类、下载量以任务给出的列表信息为准，安装前请在 SkillHub 再次确认。
这是什么¶
「万方检索skill」是挂在 SkillHub 上的 Agent Skill，采用标准 SKILL.md 格式，供 Cursor、Claude Code、Codex CLI 等支持 Skills 的客户端加载。
它解决的是：在对话里完成学术检索、引用分析、文献综述与参考文献整理，而不必每次手写 OpenAlex 查询参数。维护方与版本以 SkillHub 页面为准；简介归属为社区发布技能，canonical 命名空间形态为 @user_caed61ea/slug1234567（以安装提示为准）。
核心功能¶
以下能力与官方简介及对应 SKILL.md 描述一致，可按需触发：
- 论文检索：按主题、作者、DOI 在 OpenAlex 中搜索（覆盖海量学术作品索引）。
- 结构化元数据：返回标题、作者、摘要（若有）、被引次数、DOI、开放获取链接等字段。
- 引用链分析：查看某篇论文的被引或参考文献方向（forward / backward / both）。
- 深读：在摘要基础上，对开放获取全文尝试拉取可读内容。
- 自动文献综述：多查询变体检索、去重排序、主题聚类，并输出 Markdown 或 JSON 综述稿。
触发场景包括：academic search、paper lookup、citation analysis、literature review、research synthesis、scholarly reference gathering 等表述。
SkillHub 列表信息（安装前请自行复核）：分类 knowledge-management，评分约 99088，下载约 523 次。
安装与启用¶
1. 安装 SkillHub CLI（可选）¶
若本机尚未安装 skillhub，可按 SkillHub 安装文档执行：
command -v skillhub && skillhub --version
未安装时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2. 安装技能到当前 Agent¶
SkillHub 通用安装说明见 https://skillhub.cn/install/skillhub.md。对支持自然语言安装的客户端，可使用类似提示：
请根据 https://skillhub.cn/install/skillhub.md，安装 @user_caed61ea/slug1234567。
使用 CLI 时，需用 --dir 指向当前 Agent 的 skills 目录，否则可能装到默认 ./skills/ 而未被加载。常见路径示例：
| 客户端 | Skills 目录（示例） |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
skillhub search 万方检索
skillhub install @user_caed61ea/slug1234567 --dir ~/.cursor/skills/
安装后重启或刷新 Agent，使 SKILL.md 进入技能列表。本技能简介标注 无需 API Key（requires_api_key: false）。
典型用法¶
技能包内通常提供 scripts/scholar-search.py 与 scripts/literature-review.py（以你安装后的目录为准）。下列命令与公开 SKILL.md 示例一致，需在技能根目录下执行，并保证本机有 python3。
按主题搜索¶
python3 scripts/scholar-search.py search "transformer architectures" --limit 10
按作者搜索¶
python3 scripts/scholar-search.py author "Yann LeCun" --limit 5
按 DOI 查询¶
python3 scripts/scholar-search.py doi "10.1038/s41586-021-03819-2"
引用链¶
python3 scripts/scholar-search.py citations "10.1038/s41586-021-03819-2" --direction both
深读（摘要 + 可得全文）¶
python3 scripts/scholar-search.py deep "10.1038/s41586-021-03819-2"
自动文献综述¶
python3 scripts/literature-review.py "algorithmic literacy in education" --papers 30 --output review.md
常用参数：--papers 目标篇数；--output 输出文件；--years 2020-2025 限制年份；--json 输出结构化 JSON。综述流程会多轮检索、去重排序、主题聚类后生成 Markdown。脚本可能将中间结果缓存在 /tmp/litreview_cache/。
需要机器可读结果时，可为搜索命令加上 --json。
适用场景与注意¶
适合谁
- 需要快速扫领域、拉引用链、写文献综述的研究人员或学生。
- 希望在 Agent 对话里固定「先检索、再深读、再综述」流程的团队。
限制与注意
- 数据源是 OpenAlex，不是知网、万方商业库或校内 VPN 数据库；中文核心期刊覆盖与商业库不同，重要投稿仍要以目标数据库为准。
- 名称与能力不一致的风险：若你实际需要万方开放平台的
WFDATA_APP_KEY检索，应选用万方官方或明确对接万方 API 的 Skill，不要仅凭名称选择。 - 网络与合规：调用 OpenAlex 需能访问其公网 API；批量综述请注意频率与本地缓存目录。
- 官方页状态：安装前打开下方官方地址，确认 slug、版本与安全报告；若 404，先在 SkillHub 搜索简介中的关键词或联系发布者。
结尾¶
「万方检索skill」把 OpenAlex 检索、元数据整理、引用链与自动综述写进一套 Skill 工作流，适合作为 Agent 里的学术检索入口。使用前请分清 OpenAlex 与万方商业数据，并在 SkillHub 核实条目是否可用。
官方地址：https://api.skillhub.cn/user_caed61ea/slug1234567
