Literature Review Agent

Ověřuje citace článků, označuje halucinované, vytváří BibTeX, navrhuje související práce

od Ar9av · Ar9av/PaperOrchestra

Otestováno · Funguje ★ 8.4/10

Literature Review Agent — Ověřuje citace článků, označuje halucinované, vytváří BibTeX, navrhuje související práce

Co umí

Spouští fázi citování v pipeline akademických prací: objevuje kandidátské práce pomocí webového vyhledávání, ověřuje každou přes Semantic Scholar (fuzzy shoda názvu, časový limit, dedup), křížově kontroluje proti Crossref a OpenAlex k označení halucinovaných referencí, vytváří BibTeX soubor s deterministickými klíči a navrhuje sekce Introduction a Related Work. Spouští se, když je požádán o nalezení citací pro článek, návrh související práce nebo vytvoření ověřené bibliografie.

Testovací report

Naklonováno repo; všech 14 skriptů a každý namátkově zkontrolovaný referenční soubor (bibtex_format.py, levenshtein_match.py, dedupe_by_id.py, references/prompt.md) vrátily HTTP 200. Spuštěno bibtex_format.py na ručně vytvořeném 3-paper pool: it emitted deterministic stopword-aware keys (vaswani2017attention, zhao2023survey, he2016deep), wrote eprint/doi only when present, and wrote bibtex_key back into citation_pool.json — the baseline hand-written bib would use ad-hoc keys and never populate the pool, breaking the downstream coverage gate. check_cutoff.py and citation_coverage.py behaved as specified (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 fails with a clear 'pip install python-Levenshtein' error until that undocumented dep is installed, after which it returned 100 PASS / 31 FAIL correctly. Web-discovery + live Semantic Scholar/Crossref/OpenAlex verification were not exercised (need host web search + network), so the output score reflects only the deterministic BibTeX/coverage slice. No security smells: keys read from env, no curl|sh, no exfiltration.

Testováno: 2026-07-21 · Claude Code 2.x (agent harness)

Instalace

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.

Příkazy a ukázkové prompty

  • /literature-review-agentOvěřuje citace článků, označuje halucinované, vytváří BibTeX, navrhuje související práce

Skilly se spouštějí běžnými požadavky — žádné příkazy k zapamatování. Po instalaci ho aktivují prompty jako tyto (anglicky):

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