Literature Review Agent

Verifierar papperscitat, flaggar hallucinerade, bygger BibTeX, utarbetar relaterat arbete

Testad · Fungerar ★ 8.4/10

Vad den gör

Kör citeringssteget i en akademisk papperspipeline: upptäcker kandidatpapper via webbsökning, verifierar varje via Semantic Scholar (fuzzy title match, temporal cutoff, dedup), korsrefererar mot Crossref och OpenAlex för att flagga hallucinerade referenser, bygger en BibTeX-fil med deterministiska nycklar och utarbetar avsnitten Introduktion och Relaterat arbete. Utlöses när man ombeds hitta citat för ett papper, utarbeta relaterat arbete eller bygga en verifierad bibliografi.

Testrapport

Klonade repot; alla 14 skript och varje stickprovskontrollerad referensfil (bibtex_format.py, levenshtein_match.py, dedupe_by_id.py, references/prompt.md) returnerade HTTP 200. Körde bibtex_format.py på en handbyggd 3-papperspool: den genererade deterministiska stoppordsmedvetna nycklar (vaswani2017attention, zhao2023survey, he2016deep), skrev eprint/doi endast när det fanns, och skrev bibtex_key tillbaka till citation_pool.json — den handskrivna baslinje-bibben skulle använda ad-hoc-nycklar och aldrig fylla poolen, vilket skulle bryta den nedströms täckningsgrinden. check_cutoff.py och citation_coverage.py betedde sig som specificerat (coverage gates on a floor(0.9*N) count, so 2/3 'passed' at count 2 — slightly looser than the SKILL:s '≥90% of pool' wording). levenshtein_match.py misslyckas med ett tydligt 'pip install python-Levenshtein'-fel tills det odokumenterade beroendet installeras, varefter det returnerade 100 PASS / 31 FAIL korrekt. Webb-upptäckt + live Semantic Scholar/Crossref/OpenAlex-verifiering utfördes inte (need host web search + network), så utdataresultatet återspeglar endast den deterministiska BibTeX/täckningsskivan. Inga säkerhetsbrister: nycklar läses från env, ingen curl|sh, ingen exfiltrering.

Testad: 2026-07-21 · Claude Code 2.x (agent harness)

Installation

git clone --depth 1 https://github.com/Ar9av/PaperOrchestra.git /tmp/literature-review-agent-src
mkdir -p ~/.claude/skills
cp -R /tmp/literature-review-agent-src/skills/literature-review-agent ~/.claude/skills/literature-review-agent
# Undocumented runtime dep: scripts/levenshtein_match.py needs python-Levenshtein
pip install python-Levenshtein
# Optional deps used only if you enable those backends / cross-index checks:
#   requests            (s2_search.py, crossref_client.py, openalex_client.py, exa_search.py)
# Optional API keys (all read from env, none committed):
#   SEMANTIC_SCHOLAR_API_KEY  — higher S2 rate limit (public endpoint works without it)
#   EXA_API_KEY               — optional Exa web-search backend for Phase 1
#   PAPER_ORCHESTRA_MAILTO    — polite-pool email for Crossref/OpenAlex
# Designed as Step 3 of the PaperOrchestra pipeline; needs a workspace/outline.json + host web search for the full run.

Kommandon och exempelprompter

/literature-review-agentVerifierar papperscitat, flaggar hallucinerade, bygger BibTeX, utarbetar relaterat arbete

Skills triggas av vanliga förfrågningar — inga kommandon att memorera. Efter installationen aktiverar prompter som dessa skillen (på engelska):

Find citations for my paper's related work section
Draft the related work from this outline.json
Verify these citations against Semantic Scholar

Läs hela rapporten →