Literature Review Agent

Verificerer papircitationer, markerer hallucineret, bygger BibTeX, udarbejder relateret arbejde

Af Ar9av · Ar9av/PaperOrchestra

Testet · Virker ★ 8.4/10

Literature Review Agent — Verificerer papircitationer, markerer hallucineret, bygger BibTeX, udarbejder relateret arbejde

Hvad det gør

Kører citationsfasen af en akademisk-papir pipeline: opdager kandidatpapirer via websøgning, verificerer hver især gennem Semantic Scholar (fuzzy title match, temporal cutoff, dedup), krydstjekker mod Crossref og OpenAlex for at markere hallucineret referencer, bygger en BibTeX-fil med deterministiske nøgler og udarbejder Introduction og Related Work sektionerne. Udløses når man bedes om at finde citationer til et papir, udarbejde relateret arbejde eller bygge en verificeret bibliografi.

Testrapport

Klonede repoet; alle 14 scripts og hver stikprøvekontrolleret referencefil (bibtex_format.py, levenshtein_match.py, dedupe_by_id.py, references/prompt.md) returnerer HTTP 200. Kørte bibtex_format.py på en håndbygget 3-papirs pulje: den udsendte deterministiske stopord-bevidste nøgler (vaswani2017attention, zhao2023survey, he2016deep), skrev eprint/doi kun når til stede, og skrev bibtex_key tilbage i citation_pool.json — den baseline håndskrevne bib ville bruge ad-hoc nøgler og aldrig udfylde puljen, hvilket brød den downstream coverage gate. check_cutoff.py og citation_coverage.py opførte sig som specificeret (coverage gates på en floor(0.9*N) tælling, så 2/3 'passed' ved tælling 2 — lidt løsere end SKILL'ens '≥90% of pool' formulering). levenshtein_match.py fejler med en klar 'pip install python-Levenshtein' fejl, indtil den udokumenterede afhængighed er installeret, hvorefter den returnerede 100 PASS / 31 FAIL korrekt. Web-discovery + live Semantic Scholar/Crossref/OpenAlex verifikation blev ikke udført (kræver host web search + network), så outputscoren afspejler kun den deterministiske BibTeX/coverage del. Ingen sikkerhedsbrister: nøgler læses fra env, ingen curl|sh, ingen exfiltration.

Testet: 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.

Kommandoer og eksempelprompter

  • /literature-review-agentVerificerer papircitationer, markerer hallucineret, bygger BibTeX, udarbejder relateret arbejde

Skills udløses af almindelige forespørgsler — ingen kommandoer at huske. Efter installationen 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