STOP. LIES DIESE GANZE SKILL.MD, BEVOR DU EINEN ENDPUNKT AUFRUFST.
arXiv-Fähigkeit
Durchsuche arXiv und extrahiere Wissen ins Gedächtnis.
Befehle
| Befehl | Beschreibung |
|---|---|
search | Finde Paper (gibt Abstracts zur Auswahl zurück) |
learn | Extrahiere Wissen ins Gedächtnis |
download | Lade Paper-HTML herunter (Standard); Ausgabedateien werden nach dem Papiertitel benannt |
VERPFLICHTEND: Dynamische Kontexterzeugung
UNVERHANDELBAR: Vor JEDEM arXiv-Vorgang MUSS der Agent eine dynamische Kontextdatei erstellen, die die aktuellen Zusammenarbeitsziele erfasst.
Warum dies erforderlich ist
Ohne dynamischen Kontext:
- Die Suche liefert nur am Rande verwandte Paper
- Die Abstract-Auswahl entbehrt klarer Relevanzkriterien
- Das extrahierte Wissen ist generisch („Was sagt das Paper über X?“)
Mit dynamischem Kontext:
- Die Suche ist auf spezifische Implementierungsanforderungen ausgerichtet
- Die Abstract-Bewertung hat klare Annahme-/Ablehnungskriterien
- Das extrahierte Wissen ist umsetzbar („Wie implementiere ich X als Code?“)
Workflow: Kontext-zuerst-Paper-Entdeckung
0. KONTEXT → Dynamischen Kontext aus dem Gespräch erstellen (ERFORDERLICH)
1. SUCHE → Kontext verwenden, um relevante Paper zu finden
2. AUSWAHL → Abstracts anhand der Kontextziele bewerten
3. ENTSCHEID → Benutzer wählt zu extrahierende Paper aus
4. LERNEN → Mit Kontext extrahieren für fokussierte Wissenseinheiten
Schritt 0: Dynamischen Kontext erstellen (ERFORDERLICH)
Vor der Suche MUSS der Agent /tmp/arxiv_context.md mit folgendem Inhalt erstellen:
# Forschungskontext: [Dein spezifisches Ziel]
## Was wir bauen
[Beschreibe das spezifische Feature/System, z.B. „Theory of Mind für den Horus-Agenten"]
## Aktueller Stand
[Was bereits existiert, was implementiert ist, was wir haben]
## Was wir von den Papern brauchen
1. [Spezifische Frage 1, z.B. „Wie stellt man Überzeugungskonfidenz als Datenstruktur dar?"]
2. [Spezifische Frage 2, z.B. „Wann wird kontrafaktische Reflexion ausgelöst?"]
3. [Spezifische Frage 3, z.B. „Algorithmus zum Aktualisieren von Überzeugungen bei Widersprüchen"]
## Suchbegriffe zum Ausprobieren
- [Begriff 1]
- [Begriff 2]
## Relevanzkriterien für die Abstract-Auswahl
- HOCH: Paper, die sich direkt mit [spezifischem Bedarf] befassen
- MITTEL: Paper mit verwandten Techniken, die angepasst werden könnten
- NIEDRIG: Nur am Rande verwandt, überspringen, wenn nichts Besseres verfügbar
## Fokus der Wissensextraktion
- Extrahieren: [welche Art von Wissen, z.B. „Algorithmen, Datenstrukturen, Aktualisierungsregeln"]
- Überspringen: [was ignoriert werden soll, z.B. „Evaluationsmetriken, Datensatzbeschreibungen, zukünftige Arbeit"]
## Präferenz für das Ausgabeformat
Formuliere als Implementierungsprobleme, nicht als Zusammenfassungen:
- SCHLECHT: „Was sagt das Paper über X?"
- GUT: „Wie sollten wir X implementieren? Welches Code-Muster?"
Schritt 1: Mit Kontext suchen
Nachdem der Kontext erstellt wurde, verwende ihn, um die Suche zu leiten:
# Suche, geleitet von Kontextzielen
./run.sh search -q "theory of mind BDI agent belief tracking" -n 10
Schritt 2: Gegen Kontext auswählen
Bewerte jedes Abstract anhand der Relevanzkriterien des Kontexts:
## Gefundene Paper – Bewertung anhand der Kontextziele
### 1. **Papiertitel** (arXiv:XXXX.XXXXX)
> [Abstract]
**Gegen Kontext:**
- Behandelt Ziel 1 (Überzeugungsrepräsentation): JA – beschreibt BDI-Dict-Struktur
- Behandelt Ziel 2 (kontrafaktische Reflexion): NEIN
- **Urteil: HOCH** – beantwortet direkt unsere Frage zur Datenstruktur
### 2. **Papiertitel** (arXiv:XXXX.XXXXX)
> [Abstract]
**Gegen Kontext:**
- Behandelt Ziel 1: NEIN
- Behandelt Ziel 2: JA – beschreibt Reflexionsauslösebedingungen
- **Urteil: HOCH** – beantwortet direkt unsere Algorithmusfrage
---
Welche Paper soll ich extrahieren?
Schritt 3: Mit Kontextdatei extrahieren
Übergib die Kontextdatei an learn für fokussierte Extraktion:
./run.sh learn 2501.15355 --scope persona-research --context-file /tmp/arxiv_context.md
Fahre NICHT ohne Benutzerbestätigung der Papierauswahl fort.
search – Paper finden
./run.sh search -q "agent memory" -n 5
Gibt Paper mit vollständigen Abstracts zur schnellen Auswahl zurück.
| Option | Beschreibung |
|---|---|
-q | Suchabfrage (erforderlich) |
-n | Maximale Ergebnisse (Standard: 10) |
-c | Kategorie-Filter (z.B. cs.LG) |
-m | Paper aus den letzten N Monaten |
--smart | LLM übersetzt die natürlichsprachliche Abfrage |
learn – Wissen extrahieren
./run.sh learn 2601.08058 --scope memory
Vollständige Pipeline: herunterladen → profilieren → extrahieren → Q&A → interviewen → speichern → Kanten verifizieren.
| Option | Beschreibung |
|---|---|
--scope | Gedächtnisbereich (erforderlich) |
--context | Domänenfokus für Relevanz |
--dry-run | Vorschau ohne Speichern |
--skip-interview | Empfehlungen automatisch akzeptieren |
--accurate | PDF- + VLM-Extraktion erzwingen |
--mode | Interview-Modus: auto, html, tui (Standard: auto) |
Extraktionsmodus (HTML-zuerst)
NEU: Der learn-Befehl verwendet jetzt standardmäßig die HTML-zuerst-Extraktion:
- Lädt HTML von ar5iv.org herunter (arXiv-Paper, in sauberes HTML konvertiert)
- Führt eine schnelle Profilprüfung durch (zählt Abbildungen/Tabellen)
- Leitet an den geeigneten Extraktionsmodus weiter
arxiv learn <id>
│
├── schneller Modus (Standard) ──► ar5iv HTML ──► Extractor HTML
│ - Die meisten Forschungspaper (100% Extraktionsparität)
│ - Textlastige Inhalte (keine PDF-Spaltenprobleme)
│
└── genauer Modus ──► arxiv PDF ──► Extractor PDF + VLM
- Paper, bei denen Abbildungen entscheidend sind
- Komplexe Tabellen mit präzisen Werten
- Verwendung: --accurate-Flag
Warum HTML-zuerst?
| Aspekt | HTML (ar5iv) | |
|---|---|---|
| Extraktionsqualität | 100% Parität | ~87% (Probleme mit Spaltenerkennung) |
| Geschwindigkeit | Schnell (~5s) | Langsamer (~30s-2min) |
| Bildunterschriften | Enthalten | Erfordert VLM |
| Mathematische Darstellung | MathML erhalten | Text-Näherung |
| Layout-Probleme | Keine | Probleme mit 2-Spalten-Erkennung |
ar5iv.org konvertiert arXiv-LaTeX-Quellcode in semantisches HTML mit MathML-Gleichungen und korrekter Struktur. Dies eliminiert PDF-Extraktionsprobleme.
Wann --accurate verwenden
| Inhaltstyp | Empfohlener Modus | Warum |
|---|---|---|
| Die meisten Forschungspaper | Standard (HTML) | Text + Bildunterschriften sind ausreichend |
| Übersichtsarbeiten | Standard (HTML) | Breite Abdeckung, genaue Abbildungen nicht kritisch |
| Paper mit kritischen Diagrammen | --accurate | Wenn der visuelle Inhalt entscheidend ist |
| Paper mit komplexen Datentabellen | --accurate | Wenn präzise Zahlen wichtig sind |
# Standard: HTML-Extraktion (schnell, zuverlässig)
./run.sh learn 2601.10025 --scope persona-research
# Genauen Modus für figurenreiche Paper erzwingen
./run.sh learn 2501.15355 --scope tom-research --accurate
Profilbasierte Weiterleitung
Die Fähigkeit profiliert automatisch heruntergeladenes HTML, um den Extraktionsmodus vorzuschlagen:
- < 20 Abbildungen UND < 10 Tabellen: Verwendet HTML (schneller Modus)
- > 20 Abbildungen ODER > 10 Tabellen: Schlägt genauen Modus vor (oder
--accurateverwenden)
Die Profilausgabe wird in Protokollen angezeigt:
Profil: 12 Abbildungen, 4 Tabellen → Verwendet HTML-Extraktion (schneller Modus)
Happy Path
# 1. Suchen – Abstracts erhalten
./run.sh search -q "agent memory systems" -n 5
# 2. STOP – Abstracts mit Benutzer besprechen, Relevanz bewerten
# 3. Lernen – Vom Benutzer ausgewählte Paper extrahieren (HTML-Extraktion standardmäßig)
./run.sh learn 2601.10702 --scope memory --context "agent systems"
Beispiele
Forschungsübersicht (HTML-Extraktion – Standard)
./run.sh learn 2601.10025 --scope persona-research --context "LLM personality"
Paper mit kritischen Abbildungen (genauer Modus)
./run.sh learn 2501.15355 --scope tom-research --context "BDI architecture" --accurate
Trockenlauf zuerst
# Vorschau, was extrahiert würde
./run.sh learn 2601.10025 --scope test --dry-run
Nur HTML herunterladen
# Lade ar5iv-HTML zur manuellen Inspektion herunter (Standard; Titel-basierter Dateiname)
./run.sh download -i 2501.15355
# Lade PDF nur bei Bedarf herunter
./run.sh download -i 2501.15355 --format pdf
Batch-Verarbeitung (Parallel)
# Mehrere Paper parallel verarbeiten (Standard: 2 gleichzeitig)
./run.sh batch 2501.15355 2502.14171 2310.10701 --scope tom-research --context-file /tmp/context.md
# Parallelität für schnellere Verarbeitung erhöhen
./run.sh batch 2501.15355 2502.14171 2310.10701 --scope research --parallel 3
# Trockenlauf zur Vorschau
./run.sh batch 2501.15355 2502.14171 --scope test --dry-run
| Option | Beschreibung |
|---|---|
--parallel N | Maximale Anzahl gleichzeitig zu verarbeitender Paper (Standard: 2) |
--context-file | Umfangreiche Kontextdatei für fokussierte Extraktion |
--skip-interview | Automatisch akzeptieren (Standard für Batch) |
--dry-run | Vorschau ohne Speichern |
Hinweis: Empfohlene Parallelität beträgt 2-3 Paper. Höhere Werte können API-Ratenlimits erreichen.
Häufige Fehler
FALSCH: Suchen, ohne vorher Kontext zu erstellen
./run.sh search -q "agent memory" -n 10
RICHTIG: Zuerst /tmp/arxiv_context.md erstellen, DANN suchen
# 1. Kontextdatei mit spezifischen Zielen und Relevanzkriterien schreiben
# 2. Dann durch Kontext geleitete Suche
./run.sh search -q "agent memory BDI belief tracking" -n 10
FALSCH: Paper ohne Benutzerbestätigung extrahieren
# Agent extrahiert automatisch alle 10 Suchergebnisse
./run.sh learn 2501.15355 --scope research
./run.sh learn 2502.14171 --scope research
RICHTIG: Abstracts präsentieren, Benutzer auswählen lassen, dann extrahieren
./run.sh search -q "agent memory" -n 10
# STOP – Abstracts mit Benutzer besprechen, Relevanz bewerten
# Benutzer wählt Paper 2 und 5 aus
./run.sh learn 2501.15355 --scope research --context-file /tmp/arxiv_context.md
FALSCH: --accurate für textlastige Paper verwenden
./run.sh learn 2601.10025 --scope research --accurate # verschwendet Zeit mit PDF-Extraktion
RICHTIG: Standard-HTML-Modus für die meisten Paper, --accurate nur für figurenreiche
./run.sh learn 2601.10025 --scope research # HTML ist schneller und zuverlässiger
Abhängigkeiten
| Komponente | URL | Zweck |
|---|---|---|
| ar5iv.org | https://ar5iv.org | LaTeX-zu-HTML-Konvertierung für arXiv-Paper |
| extractor-Fähigkeit | (Geschwisterfähigkeit) | HTML/PDF-Inhaltsextraktion |
| qra-Fähigkeit | (Geschwisterfähigkeit) | Q&A-Paar-Generierung aus Text |
QRA-Training-Fehlerbehebungshinweis (2026-09-14)
Beobachtet während der qra-training-Forschung: download --format html schlug fehl, als
die arXiv-Metadaten-API 429 zurückgab oder vor dem HTML/PDF-Download-Schritt eine Zeitüberschreitung auftrat.
Die CLI behandelt die Metadatensuche nun als optional für direkte Paper-IDs. Falls die Metadaten
fehlschlagen, erstellt sie direkte Fallback-URLs und versucht der Reihe nach:
https://arxiv.org/html/<id-mit-version>https://arxiv.org/html/<basis-id>https://ar5iv.org/abs/<basis-id>https://ar5iv.labs.arxiv.org/html/<basis-id>
Ein Metadatenfehler sollte in warnings[] erscheinen, nicht in errors[], wenn eine dieser
Inhalts-URLs erfolgreich ist.