前言¶
寫綜述或開題時，常見做法是手動在數據庫裏換關鍵詞、抄元數據、再整理引用鏈。把 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
