Literature Review Agent

Weryfikuje cytowania w artykułach, oznacza halucynowane, buduje BibTeX, szkicuje prace pokrewne

Testowano · Działa ★ 8.4/10

Co robi ten skill

Uruchamia etap cytowania w potoku artykułów akademickich: odkrywa kandydatów na artykuły poprzez wyszukiwanie w sieci, weryfikuje każdy przez Semantic Scholar (rozmyte dopasowanie tytułu, odcięcie czasowe, deduplikacja), krzyżowo sprawdza z Crossref i OpenAlex, aby oznaczyć halucynowane referencje, buduje plik BibTeX z deterministycznymi kluczami i szkicuje sekcje Introduction i Related Work. Uruchamia się, gdy zostanie poproszony o znalezienie cytowań do artykułu, szkicowanie prac pokrewnych lub zbudowanie zweryfikowanej bibliografii.

Raport z testu

Sklonowano repozytorium; wszystkie 14 skryptów i każdy sprawdzony plik referencyjny (bibtex_format.py, levenshtein_match.py, dedupe_by_id.py, references/prompt.md) zwróciły HTTP 200. Uruchomiono bibtex_format.py na ręcznie zbudowanej puli 3 artykułów: wyemitował deterministyczne klucze uwzględniające słowa stop (vaswani2017attention, zhao2023survey, he2016deep), zapisał eprint/doi tylko wtedy, gdy były obecne, i zapisał bibtex_key z powrotem do citation_pool.json — bazowy, ręcznie napisany bib używałby kluczy ad hoc i nigdy nie wypełniałby puli, łamiąc bramkę pokrycia. check_cutoff.py i citation_coverage.py zachowywały się zgodnie ze specyfikacją (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 zawodzi z wyraźnym błędem 'pip install python-Levenshtein' dopóki ta nieudokumentowana zależność nie zostanie zainstalowana, po czym zwrócił poprawnie 100 PASS / 31 FAIL. Wyszukiwanie w sieci + weryfikacja na żywo Semantic Scholar/Crossref/OpenAlex nie zostały wykonane (need host web search + network), więc wynik wyjściowy odzwierciedla tylko deterministyczny wycinek BibTeX/pokrycia. Brak zagrożeń bezpieczeństwa: klucze odczytywane z env, brak curl|sh, brak eksfiltracji.

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

Instalacja

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.

Komendy i przykładowe prompty

/literature-review-agentWeryfikuje cytowania w artykułach, oznacza halucynowane, buduje BibTeX, szkicuje prace pokrewne

Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):

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

Pełny raport →