Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
lit-review-kit — Claude Code 學術論文搜尋與文獻回顧技能組
Academic Literature Search & Review Skills for Claude Code — 用自然語言在 Claude Code 裡搜尋學術論文、自動產生文獻回顧報告。
一組可安裝的 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> lit-review-kit
cd lit-review-kit
./install.sh /path/to/your-project # 安裝全部三個技能
./install.sh /path/to/your-project paper-search # 只裝輕量搜尋
./install.sh /path/to/your-project deep-research # 自動含 remi-reviewinstall.sh 會：複製選定技能到 <專案>/.claude/skills/、建立或提示合併 .mcp.json、建立 output/，並印出後續步驟。
方式 B：手動安裝（含 Windows）
- 複製技能資料夾到你的專案：把
.claude/skills/下要用的技能（paper-search、deep-research、remi-review）整個資料夾複製到你的專案/.claude/skills/。 - 複製
.mcp.json到專案根目錄（若已有，手動把semantic-scholar區塊合併進去）。 - 在專案根目錄建立
output/資料夾。
Windows PowerShell 複製範例： ``powershell Copy-Item -Recurse .\.claude\skills\* "你的專案\.claude\skills\" Copy-Item .\.mcp.json "你的專案\.mcp.json" ``🔧 需求 Requirements
- Claude Code 與 Node.js 18+
npm install -g @anthropic-ai/claude-code- 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"- Semantic Scholar API Key（建議，免費）— 申請後把
.mcp.json裡的YOUR_KEY換掉：
<https://www.semanticscholar.org/product/api> （沒 key 也能跑，但與其他匿名用戶共享流量，較易被限速）
- 深度模式 Python 依賴（選用，僅
deep-research的 PDF 抓取需要）：
pip install -r .claude/skills/deep-research/requirements.txt # 只裝 PyMuPDF⚠️ 授權注意 PyMuPDF / AGPL：deep-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.json 的 disabledMcpjsonServers 移除。）
💡 使用範例 Usage
輕量模式（paper-search）：
> 幫我找近五年關於遊戲化學習對大學生學習動機影響的高引用論文，要 10 篇
> 第 3 篇和第 7 篇幫我看詳細摘要，它們用什麼研究方法
> 把這 10 篇匯出成 BibTeX深度模式（deep-research）：
> 幫我寫一篇關於「生成式 AI 對大學寫作教學影響」的文獻回顧報告（agent 會先提出研究藍圖等你確認，再執行 7 階段 pipeline，最後在 output/ 產出 Markdown 報告 + BibTeX。）
🗂️ 專案結構 Project structure
lit-review-kit/
├── 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）——完整原始授權全文見 NOTICE，LICENSE 末段亦附改編出處。