前言¶
做文獻綜述時，常見的做法是人工在數據庫裏一篇篇搜、一篇篇讀，再手工整理引用關係。這個過程既慢，又容易漏掉相關文獻。下面介紹的 Skill 把這一步自動化：它通過 OpenAlex API（免費、無需 API 密鑰）檢索學術論文，支持按主題、作者、DOI 查找，並能展開引用鏈、抓取開放獲取全文，最後自動生成結構化的文獻綜述。
需要說明的是，這個 Skill 解決的是「找文獻 + 彙總」這一環，不負責論文寫作、選題論證或 LaTeX 排版。
這是什麼¶
Academic Research 是一個面向學術檢索的 Agent Skill，座標 @clawhub_rogersuperbuilderalpha/academic-research，由 rogersuperbuilderalpha 發佈，頁面另標註 Built by Topanga — AI Research Consultant。許可證爲 MIT-0，當前版本 v1.0.0。它封裝了 OpenAlex 學術數據庫的查詢能力，把「檢索 → 去重 → 主題聚類 → 綜述合成」做成可直接調用的命令行腳本。
底層數據源是 OpenAlex，收錄約 2500 萬篇學術作品，全程無需密鑰，適合在 Agent 或自動化流程裏作爲文獻檢索的一環。
核心功能¶
已覈實的能力如下：
- 按主題搜索論文，支持限制返回數量和按引用量排序。
- 按作者搜索。
- 按 DOI 精確查找單篇論文。
- 展開引用鏈，查看某篇論文的施引文獻和參考文獻（
--direction both表示雙向）。 - 深度讀取，抓取摘要及開放獲取全文（若可用）。
- 結構化輸出，每篇論文返回標題、年份、作者（至多 5 位）、摘要、引用數、DOI、開放獲取 URL、來源期刊/會議。
- 自動文獻綜述：多查詢變體檢索、去重與相關性+引用排序、主題聚類，並生成 Markdown 綜述。
- JSON 輸出，便於程序化調用。
安裝與啓用¶
Skill 基於通用 SKILL.md 格式，通過 ClawHub 生態的 CLI 安裝。官方安裝命令如下：
npx skills
# 或
openclaw skills install @rogersuperbuilderalpha/academic-research
安裝後，Skill 內部提供兩個 Python 腳本：scripts/scholar-search.py 用於檢索，scripts/literature-review.py 用於綜述生成。運行環境需具備 Python 3 與腳本所依賴的 HTTP 庫（用於訪問 OpenAlex API）。
官方地址：https://api.skillhub.cn/user_b18c475a/academic-research
上游倉庫：https://clawhub.ai/rogersuperbuilderalpha/academic-research
典型用法¶
下面的例子來自上游倉庫的官方說明。
按主題搜索，限制返回 10 篇：
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"
以 JSON 格式輸出，便於程序消費：
python3 scripts/scholar-search.py search "CRISPR" --json
自動生成文獻綜述，目標 30 篇，寫入 review.md：
python3 scripts/literature-review.py "algorithmic literacy in education" --papers 30 --output review.md
該綜述腳本支持以下參數：
--papers N：目標文獻數量，默認 20。--output FILE：輸出文件，默認輸出到標準輸出。--years 2020-2025：限定發表年份範圍。--json：輸出結構化 JSON 而非 Markdown。
綜述腳本會把檢索結果緩存在 /tmp/litreview_cache/ 下，避免重複請求。
適用場景與注意¶
適合的場景：需要快速建立某一主題的文獻全景、做引用關係溯源、或爲綜述報告批量收集與歸類文獻。由於底層是 OpenAlex，覆蓋以英文爲主的國際期刊與會議，中文文獻覆蓋有限。
需要注意的幾點：
- OpenAlex 默認按相關性排序；若要按影響力查看，需加
--sort citations。 - 快速分診建議先 search、再對有希望的命中跑 deep。
- 全文 PDF 需要自行處理：把 DOI 傳給 PDF 抽取工具，Skill 本身只負責定位。
- 引用數、開放獲取 URL 等字段依賴 OpenAlex 的元數據完整性，部分舊文獻可能缺失。
- 綜述腳本依賴網絡訪問 OpenAlex，緩存目錄爲
/tmp，重啓後可能失效。
結尾¶
Academic Research 的價值在於把「找文獻」這一步從手工勞動裏抽出來，用 OpenAlex 的免費接口完成檢索、引用鏈展開和綜述合成。它不覆蓋論文寫作與排版，只負責到「結構化綜述」爲止。如果你的流程裏缺的是文獻檢索這一環，可以從官方地址安裝試用。
官方地址：https://api.skillhub.cn/user_b18c475a/academic-research
上游倉庫：https://clawhub.ai/rogersuperbuilderalpha/academic-research
