Skip to content

billy1125/Ronbun

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Ronbun — Claude Code 學術論文搜尋與文獻回顧技能組

Academic Literature Search & Review Skills for Claude Code — 用自然語言在 Claude Code 裡搜尋學術論文、自動產生文獻回顧報告。

License: MIT Claude Code Semantic Scholar

一組可安裝的 Claude Code skills,把學術研究工作流程拆成「輕量搜尋 → 觸發深度解析」兩層:用 Semantic Scholar 快速找論文,需要時再啟動嚴謹的 文獻回顧(literature review)pipeline,跨 OpenAlex / Crossref / WebSearch 在設定的品質門檻內廣泛探索、全文精讀、反幻覺 DOI 驗證與自動化品質檢查,最後產出 Markdown 報告 + APA / BibTeX

關鍵字 Keywords:Claude Code skill、學術論文搜尋、文獻回顧自動化、Semantic Scholar MCP、OpenAlex、Crossref、literature review automation、academic paper search、AI research agent、APA、BibTeX、繁體中文。


⚠️ 免責聲明與使用須知 Disclaimer

請先讀完再使用。 使用本專案即表示你已理解並接受以下事項。

  • 專案性質 Side project:這是作者個人研究與測試用的 side project,內容多為與 AI 協作產生的初稿測試尚未完整、可能含有錯誤或 bug,並非正式、穩定或經完整驗證的產品。
  • 不保證正確性與合法性 No warranty:論文搜尋結果、metadata(標題/作者/年份/DOI/引用數)、全文解析,以及一切延伸/衍生生成內容(AI 摘要、綜述、文獻回顧報告等)皆不保證正確、完整或合法請務必回到原始出處查證後再使用或引用。 作者不對任何因使用本專案而產生的後果負責(一切依 MIT 授權 之「AS IS」免責條款)。
  • 學術倫理 Academic integrity:AI 產生的摘要/綜述/報告僅供輔助,不可未經查證即引用、亦不可直接當成自己的著作;請遵守你所屬機構與期刊的學術誠信規範。
  • 版權與下載限制 Copyright & access:僅下載你有合法權限取得的內容(開放取用 OA 或機構授權範圍);請勿用本工具繞過付費牆,或違反出版商服務條款(ToS)/ robots 規範;下載之全文僅供個人研究分析,再散布須符合原始授權。
  • 使用者自負責任 Use at your own risk

✨ 功能特色 Features

能力 說明
🔍 輕量論文搜尋 透過 Semantic Scholar MCP 檢索 2 億+ 篇論文,整理成表格 + 中文摘要
📚 深度文獻回顧 7 階段 pipeline:全文精讀 → 多來源探索 → DOI 驗證 → 品質檢查 → 報告
🧪 反幻覺驗證 每個引用都對 Crossref 實際驗證存活,假 DOI 會被擋下
🚫 可設定的品質過濾 預設只收 Q1–Q2、排除 MDPI(DOI 前綴 10.3390)與 Q4;門檻可調整或關閉,並於報告揭露納入/排除條件
🔎 自動化品質檢查 仿學術審稿的 10 點檢查清單,標記可能問題、不捏造引用(非真人同儕審查
📤 標準匯出 APA 第七版文字清單 + 標準 BibTeX,輸出到 output/

🧩 技能總覽 Skills

技能 何時觸發 產出
paper-search 「幫我找 X 的論文」「列出某主題文獻」「追蹤引用」 表格 + 中文摘要 + BibTeX
deep-research 「寫一篇 X 的文獻回顧 / 研究報告」 Markdown 報告 + APA/BibTeX
remi-review 「幫我審查這份草稿」(deep-research Phase 5 自動使用) AI 輔助審閱(自動化 10 點檢查清單)+ 修改建議

技能依 Claude Code 規範放在 .claude/skills/,會被自動探索;使用者用自然語言描述需求即可觸發,無需手動指定。

🚀 安裝 Installation

方式 A:一鍵安裝(macOS / Linux)

把這個 repo clone 下來,對你的專案執行 install.sh

git clone <this-repo> Ronbun
cd Ronbun
./install.sh /path/to/your-project            # 安裝全部三個技能
./install.sh /path/to/your-project paper-search   # 只裝輕量搜尋
./install.sh /path/to/your-project deep-research   # 自動含 remi-review

install.sh 會:複製選定技能到 <專案>/.claude/skills/、建立或提示合併 .mcp.json、建立 output/,並印出後續步驟。

方式 B:手動安裝(含 Windows)

  1. 複製技能資料夾到你的專案:把 .claude/skills/ 下要用的技能(paper-searchdeep-researchremi-review)整個資料夾複製到 你的專案/.claude/skills/
  2. 複製 .mcp.json 到專案根目錄(若已有,手動把 semantic-scholar 區塊合併進去)。
  3. 在專案根目錄建立 output/ 資料夾。

Windows PowerShell 複製範例:

Copy-Item -Recurse .\.claude\skills\* "你的專案\.claude\skills\"
Copy-Item .\.mcp.json "你的專案\.mcp.json"

🔧 需求 Requirements

  1. Claude CodeNode.js 18+
    npm install -g @anthropic-ai/claude-code
  2. uv(執行 MCP server 用)
    # macOS / Linux
    curl -LsSf https://astral.sh/uv/install.sh | sh
    # Windows (PowerShell)
    powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
  3. Semantic Scholar API Key(建議,免費)— 申請後把 .mcp.json 裡的 YOUR_KEY 換掉: https://www.semanticscholar.org/product/api (沒 key 也能跑,但與其他匿名用戶共享流量,較易被限速)
  4. 深度模式 Python 依賴(選用,僅 deep-research 的 PDF 抓取需要):
    pip install -r .claude/skills/deep-research/requirements.txt   # 只裝 PyMuPDF

    ⚠️ 授權注意 PyMuPDF / AGPLdeep-research 的 PDF 抓取依賴 PyMuPDF(AGPL-3.0 授權)。本專案不打包該套件、由使用者自行 pip install,因此本專案本身維持 MIT 授權。但 AGPL 含網路條款:若你打算把本工具散布為產品跑成對外網路服務(SaaS),AGPL 的原始碼揭露義務可能被觸發。屆時請改用 MIT 授權的 PDF 套件(如 pdfplumber),或向 Artifex 取得 PyMuPDF 商業授權,並自行評估法律風險。

啟動後在 Claude Code 輸入 /mcp,看到 semantic-scholar 顯示 connected 即成功。 (若被停用,請把它從 .claude/settings.local.jsondisabledMcpjsonServers 移除。)

💡 使用範例 Usage

輕量模式(paper-search):

> 幫我找近五年關於遊戲化學習對大學生學習動機影響的高引用論文,要 10 篇
> 第 3 篇和第 7 篇幫我看詳細摘要,它們用什麼研究方法
> 把這 10 篇匯出成 BibTeX

深度模式(deep-research):

> 幫我寫一篇關於「生成式 AI 對大學寫作教學影響」的文獻回顧報告

(agent 會先提出研究藍圖等你確認,再執行 7 階段 pipeline,最後在 output/ 產出 Markdown 報告 + BibTeX。)

🗂️ 專案結構 Project structure

Ronbun/
├── install.sh                      # 一鍵安裝腳本
├── .mcp.json                       # MCP 設定範本(semantic-scholar)
├── README.md / CLAUDE.md / LICENSE
├── output/                         # 報告 / BibTeX 輸出(自動建立)
└── .claude/skills/
    ├── paper-search/SKILL.md       # 輕量檢索
    ├── deep-research/              # 深度 pipeline(scripts / references / templates)
    └── remi-review/SKILL.md        # AI 輔助品質檢查(自動化檢查清單)

🧹 解除安裝 Uninstall

刪除你專案 .claude/skills/ 下對應的技能資料夾即可;若不再使用,也可移除 .mcp.json 裡的 semantic-scholar 區塊。

🛠️ 疑難排解 Troubleshooting

  • MCP 連不上 → 確認 uv --version 可執行;確認 semantic-scholar 未被 .claude/settings.local.json 停用。
  • 搜尋很慢或被限速 → 確認已填入 API key。
  • 找不到論文 → 換英文關鍵字,或請 agent 調整搜尋詞。
  • 深度模式 PDF 抓取失敗 → 確認已 pip install PyMuPDF;遇付費牆全文則改抓 OA 來源或捨棄該篇。

📄 授權 License

MIT © 2026 Cho-Hsun Lu (billy1125) — 內容「AS IS」提供,不負擔保責任,另見上方免責聲明

deep-research / remi-review 改編自 CYC2002tommy/Deep-Research-Agent(MIT),已移植為 Claude Code 原生流程。依 MIT 條款保留原作者著作權聲明(Copyright (c) 2026 CYC2002tommy)——完整原始授權全文見 NOTICELICENSE 末段亦附改編出處。

About

Academic Literature Search & Review Skills for Claude Code — 用自然語言在 Claude Code 裡搜尋學術論文、自動產生文獻回顧報告。

Topics

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors