JingruiYu/arxiv-paper-tracker-skill

arxiv-paper-tracker

Dies ist eine agentenorientierte Fähigkeit zum konfigurierbaren arXiv-Paper-Tracking. Wenn dieses Repository in ein Agentensystem geklont wird, das SKILL.md unterstützt, sollte der Agent diese Fähigkeit immer dann nutzen, wenn der Benutzer arXiv-Papiere unter benutzerdefinierten Einschränkungen suchen, verfolgen, deduplizieren, zusammenfassen oder regelmäßig überwachen möchte.

Geeignete Anwendungsfälle umfassen:

• Einmalige arXiv-Suche mit einer temporären, vom Agenten generierten Konfiguration.
• Regelmäßiges Paper-Tracking mit einer persistenten Seen-State-Datei.
• Überwachung einer beliebigen Kombination von Abfrageeinschränkungen, einschließlich Autoren, Institutionen, Schlüsselwörtern, arXiv-Kategorien, Datumsfenstern und Ergebnislimits.
• Generierung eines Markdown-Digests, der von einem externen Benachrichtigungssystem, einer E-Mail-Pipeline, einem Scheduler oder einem Chat-Bot gesendet werden kann.

Die Beispiele in dieser Datei sind nur Beispiele. Themen, Autoren, Institutionen, Kategorien, Zeitfenster und Ergebnislimits sind alle in config.yaml konfigurierbar.

Was diese Fähigkeit tut

Diese Fähigkeit kann:

1. arXiv abfragen.
2. Papiere nach Autoren, Institutionen, Schlüsselwörtern und Kategorien filtern.
3. Papiere anhand der arXiv-ID deduplizieren.
4. Eine lokale Seen-State-Datei führen, um wiederholte Benachrichtigungen zu vermeiden.
5. Einen Markdown-Digest generieren.
6. Optional E-Mail-Benachrichtigungen senden, wenn dies in einer lokalen Konfigurationsdatei aktiviert ist.

Diese Fähigkeit kann nicht:

• Vollständige Papiere automatisch übersetzen.
• PDFs herunterladen und tiefgehend lesen.
• Das Urteil des Benutzers über Papierqualität oder -relevanz ersetzen.
• E-Mail-Passwörter, App-Passwörter, API-Schlüssel oder andere Geheimnisse des Benutzers speichern oder verwalten.

Installation

Falls das Paket in der aktuellen Agentenlaufzeitumgebung nicht installiert ist, führen Sie dies aus dem Repository-Stammverzeichnis aus:

python -m pip install -e .

Dies installiert den Konsolenbefehl:

arxiv-paper-tracker

Falls der Konsolenbefehl nicht verfügbar ist, lautet der äquivalente Modul-Einstiegspunkt:

python -m arxiv_paper_tracker.cli

Empfohlene Verwendung

Erstellen Sie eine lokale Konfigurationsdatei:

arxiv-paper-tracker init-config config.yaml

Äquivalenter Befehl:

python -m arxiv_paper_tracker.cli init-config config.yaml

Nach dem Bearbeiten von config.yaml führen Sie einen Scan aus:

arxiv-paper-tracker scan \
  --config config.yaml \
  --state outputs/arxiv_tracker/state.json \
  --output outputs/arxiv_tracker/latest.md

Äquivalenter Befehl:

python -m arxiv_paper_tracker.cli scan \
  --config config.yaml \
  --state outputs/arxiv_tracker/state.json \
  --output outputs/arxiv_tracker/latest.md

Hinweise zur Agentennutzung

Falls der Benutzer keine vollständige Konfigurationsdatei bereitgestellt hat, kann der Agent eine temporäre lokale Konfigurationsdatei basierend auf der Anfrage des Benutzers erstellen. Die folgenden Felder sind illustrativ und sollten entsprechend dem angeforderten Thema, Autor, der Institution, Kategorie, dem Zeitfenster und dem Ergebnislimit geändert werden:

queries:
  authors: []
  categories: []
  keywords: []
  institutions: []

limits:
  max_results_per_query: 20
  days_back: 7

state:
  path: outputs/arxiv_tracker/state.json

email:
  enabled: false

Dann ausführen:

arxiv-paper-tracker scan \
  --config config.yaml \
  --state outputs/arxiv_tracker/state.json \
  --output outputs/arxiv_tracker/latest.md

Falls der Benutzer nur eine einmalige Suche anstelle eines langfristigen Trackings wünscht, kann der Agent temporäre Pfade verwenden:

arxiv-paper-tracker scan \
  --config /tmp/arxiv_tracker_config.yaml \
  --state /tmp/arxiv_tracker_state.json \
  --output /tmp/arxiv_tracker_digest.md

Ausgabehandhabung

Der Scan-Befehl:

1. Gibt den Digest auf stdout aus.
2. Schreibt den Digest in eine Markdown-Datei, wenn --output angegeben ist.

Der Agent sollte stdout oder die --output-Datei lesen und dann den Markdown für die Zieloberfläche anpassen, z. B. Terminal, Web-UI, E-Mail, Feishu, DingTalk, Slack, Discord oder eine andere Chat-Oberfläche.

Planung

Dieses Repository hängt nicht von einem bestimmten Agenten-Framework ab. Für periodische Ausführungen lösen Sie den scan-Befehl von einem beliebigen Scheduler oder einer Automatisierungslaufzeitumgebung aus, z. B.:

• OpenClaw oder eine andere skill-bewusste Agentenlaufzeitumgebung.
• Claude Code oder ein anderer lokaler Codierungsagent.
• Ein anderer Agenten-Scheduler.
• cron.
• GitHub Actions.
• Ein benutzerdefinierter Scheduler.

Der Scheduler muss lediglich den scan-Befehl ausführen und den generierten Markdown-Digest über seinen eigenen Benachrichtigungskanal zustellen.

Sicherheitsregeln

• Das öffentliche Repository stellt nur config.example.yaml bereit.
• Committen Sie keine persönlichen config.yaml-Dateien.
• Die E-Mail-Benachrichtigung ist standardmäßig deaktiviert.
• Wenn E-Mail aktiviert ist, müssen SMTP-Benutzername und App-Passwort nur in einer lokalen Konfigurationsdatei leben.
• Lokale Konfigurationsdateien sollten von git ignoriert werden.
• Geben Sie keine E-Mail-App-Passwörter, API-Schlüssel, Cookies oder Token in Prompts, Logs, GitHub-Issues oder öffentlichen Ausgaben preis.