Literature Review Agent

Verifica le citazioni di articoli, segnala quelle allucinate, crea BibTeX, redige lavori correlati.

Promosso ★ 8.4/10

Cosa fa

Esegue la fase di citazione di una pipeline di articoli accademici: scopre articoli candidati tramite ricerca web, verifica ciascuno tramite Semantic Scholar (corrispondenza approssimativa del titolo, taglio temporale, deduplicazione), verifica incrociata con Crossref e OpenAlex per segnalare riferimenti allucinati, costruisce un file BibTeX con chiavi deterministiche e redige le sezioni Introduzione e Lavori Correlati. Si attiva quando viene chiesto di trovare citazioni per un articolo, redigere i lavori correlati o costruire una bibliografia verificata.

Rapporto di test

Clonata la repo; tutti i 14 script e ogni file di riferimento controllato a campione (bibtex_format.py, levenshtein_match.py, dedupe_by_id.py, references/prompt.md) restituiscono HTTP 200. Eseguito bibtex_format.py su un pool di 3 articoli costruito a mano: ha emesso chiavi deterministiche sensibili alle stopword (vaswani2017attention, zhao2023survey, he2016deep), ha scritto eprint/doi solo se presenti, e ha scritto bibtex_key di nuovo in citation_pool.json — la biblio scritta a mano di baseline avrebbe usato chiavi ad-hoc e non avrebbe mai popolato il pool, rompendo il gate di copertura a valle. check_cutoff.py e citation_coverage.py si sono comportati come specificato (gate di copertura su un conteggio floor(0.9*N), quindi 2/3 'passati' al conteggio 2 — leggermente più permissivo della formulazione della SKILL '≥90% del pool'). levenshtein_match.py fallisce con un chiaro 'pip install python-Levenshtein' error finché non viene installata quella dipendenza non documentata, dopodiché ha restituito 100 PASS / 31 FAIL correttamente. La scoperta web + la verifica live di Semantic Scholar/Crossref/OpenAlex non sono state esercitate (necessitano di ricerca web host + rete), quindi il punteggio di output riflette solo la slice deterministica BibTeX/copertura. Nessun problema di sicurezza: chiavi lette dall'ambiente, nessun curl|sh, nessuna esfiltrazione.

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

Installazione

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.

Comandi e prompt di esempio

/literature-review-agentVerifica le citazioni di articoli, segnala quelle allucinate, crea BibTeX, redige lavori correlati.

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

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

Rapporto completo →