Literature Review Agent

Verifiserer papirsitater, flagger hallusinerte, bygger BibTeX, utarbeider relatert arbeid

av Ar9av · Ar9av/PaperOrchestra

Bestått ★ 8.4/10

Literature Review Agent — Verifiserer papirsitater, flagger hallusinerte, bygger BibTeX, utarbeider relatert arbeid

Hva den gjør

Kjører siteringsfasen av en akademisk-papir-pipeline: oppdager kandidatpapirer via websøk, verifiserer hver gjennom Semantic Scholar (fuzzy title match, temporal cutoff, dedup), kryssjekker mot Crossref og OpenAlex for å flagge hallusinerte referanser, bygger en BibTeX-fil med deterministiske nøkler, og utarbeider introduksjons- og relatert arbeid-seksjonene. Utløses når man blir bedt om å finne sitater for et papir, utarbeide relatert arbeid, eller bygge en verifisert bibliografi.

Testrapport

Klonet repoet; alle 14 skript og hver stikkprøvekontrollerte referansefil (bibtex_format.py, levenshtein_match.py, dedupe_by_id.py, references/prompt.md) returnerer HTTP 200. Kjørte bibtex_format.py på en håndbygd 3-papirs samling: den sendte ut deterministiske stopord-bevisste nøkler (vaswani2017attention, zhao2023survey, he2016deep), skrev eprint/doi kun når til stede, og skrev bibtex_key tilbake i citation_pool.json — den håndskrevne baseline-biben ville brukt ad-hoc nøkler og aldri fylt opp samlingen, noe som brøt nedstrøms dekningsporten. check_cutoff.py og citation_coverage.py oppførte seg som spesifisert (dekningsporter på et floor(0.9*N) antall, så 2/3 'bestått' ved antall 2 — litt løsere enn SKILLs '≥90% av samlingen' formulering). levenshtein_match.py feiler med en klar 'pip install python-Levenshtein' feil til den udokumenterte avhengigheten er installert, hvoretter den returnerte 100 PASS / 31 FAIL korrekt. Web-discovery + live Semantic Scholar/Crossref/OpenAlex verifisering ble ikke utført (trenger host web search + nettverk), så utdata-score reflekterer kun den deterministiske BibTeX/deknings-delen. Ingen sikkerhetsbrudd: nøkler lest fra env, ingen curl|sh, ingen eksfiltrering.

Testet på: 2026-07-21 · Claude Code 2.x (agent harness)

Installer

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.

Kommandoer og eksempelprompter

  • /literature-review-agentVerifiserer papirsitater, flagger hallusinerte, bygger BibTeX, utarbeider relatert arbeid

Skills utløses av vanlige forespørsler — ingen kommandoer å huske. Etter installasjonen aktiverer prompter som disse skillen (på engelsk):

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