Literature Review Agent

Vérifie les citations d'articles, signale les citations hallucinées, construit BibTeX, rédige les travaux connexes

Testé · Fonctionne ★ 8.4/10

Ce que fait

Exécute l'étape de citation d'un pipeline d'articles académiques : découvre les articles candidats via la recherche web, vérifie chacun via Semantic Scholar (correspondance de titre floue, seuil temporel, déduplication), recoupe avec Crossref et OpenAlex pour signaler les références hallucinées, construit un fichier BibTeX avec des clés déterministes, et rédige les sections Introduction et Travaux Connexes. Se déclenche lorsqu'on lui demande de trouver des citations pour un article, de rédiger les travaux connexes, ou de construire une bibliographie vérifiée.

Rapport de test

Dépôt cloné ; les 14 scripts et chaque fichier de référence vérifié (bibtex_format.py, levenshtein_match.py, dedupe_by_id.py, references/prompt.md) renvoient HTTP 200. Exécuté bibtex_format.py sur un pool de 3 articles construit à la main : il a émis des clés déterministes sensibles aux mots vides (vaswani2017attention, zhao2023survey, he2016deep), a écrit eprint/doi uniquement si présent, et a réécrit bibtex_key dans citation_pool.json — la biblio manuscrite de base utiliserait des clés ad-hoc et ne peuplerait jamais le pool, brisant la porte de couverture en aval. check_cutoff.py et citation_coverage.py se sont comportés comme spécifié (portes de couverture sur un compte floor(0.9*N), donc 2/3 'passés' au compte 2 — légèrement plus lâche que la formulation '≥90% du pool' de la compétence). levenshtein_match.py échoue avec une erreur claire 'pip install python-Levenshtein' jusqu'à ce que cette dépendance non documentée soit installée, après quoi il a renvoyé 100 PASS / 31 FAIL correctement. La découverte web + la vérification en direct Semantic Scholar/Crossref/OpenAlex n'ont pas été exercées (nécessite une recherche web hôte + réseau), donc le score de sortie ne reflète que la tranche BibTeX/couverture déterministe. Aucune faille de sécurité : clés lues depuis l'environnement, pas de curl|sh, pas d'exfiltration.

Testé le: 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.

Commandes et exemples de prompts

/literature-review-agentVérifie les citations d'articles, signale les citations hallucinées, construit BibTeX, rédige les travaux connexes

Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :

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

Rapport complet →