JingruiYu/arxiv-paper-tracker-skill

arxiv-paper-tracker

Il s'agit d'une compétence orientée agent pour le suivi configurable d'articles arXiv. Lorsque ce dépôt est cloné dans un système d'agent prenant en charge SKILL.md, l'agent doit utiliser cette compétence dès que l'utilisateur souhaite rechercher, suivre, dédupliquer, résumer ou surveiller périodiquement des articles arXiv selon des contraintes définies par l'utilisateur.

Les cas d'utilisation appropriés incluent :

• Recherche unique sur arXiv à l'aide d'une configuration temporaire générée par l'agent.
• Suivi périodique d'articles avec un fichier d'état persistant des articles déjà vus.
• Surveillance de toute combinaison configurable de contraintes de requête, incluant les auteurs, institutions, mots-clés, catégories arXiv, fenêtres de dates et limites de résultats.
• Génération d'un digest Markdown pouvant être envoyé par un système de notification externe, un pipeline d'e-mail, un planificateur ou un chatbot.

Les exemples dans ce fichier ne sont que des exemples. Les sujets, auteurs, institutions, catégories, fenêtres temporelles et limites de résultats sont tous configurables dans config.yaml.

Ce que fait cette compétence

Cette compétence peut :

1. Interroger arXiv.
2. Filtrer les articles par auteurs, institutions, mots-clés et catégories.
3. Dédupliquer les articles par identifiant arXiv.
4. Maintenir un fichier d'état local des articles vus pour éviter les notifications répétées.
5. Générer un digest Markdown.
6. Envoyer optionnellement des notifications par e-mail lorsqu'elles sont activées dans un fichier de configuration local.

Cette compétence ne fait pas :

• Traduire automatiquement des articles complets.
• Télécharger et lire en profondeur des PDF.
• Remplacer le jugement de l'utilisateur sur la qualité ou la pertinence d'un article.
• Stocker ou gérer les mots de passe e-mail de l'utilisateur, mots de passe d'application, clés API ou autres secrets.

Installation

Si le paquet n'est pas installé dans l'environnement d'exécution actuel de l'agent, exécutez ceci depuis la racine du dépôt :

python -m pip install -e .

Ceci installe la commande console :

arxiv-paper-tracker

Si la commande console n'est pas disponible, le point d'entrée du module équivalent est :

python -m arxiv_paper_tracker.cli

Utilisation recommandée

Créez un fichier de configuration local :

arxiv-paper-tracker init-config config.yaml

Commande équivalente :

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

Après avoir modifié config.yaml, lancez une analyse :

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

Commande équivalente :

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

Conseils d'utilisation pour l'agent

Si l'utilisateur n'a pas fourni de fichier de configuration complet, l'agent peut créer un fichier de configuration local temporaire basé sur la demande de l'utilisateur. Les champs ci-dessous sont illustratifs et doivent être modifiés pour correspondre au sujet, auteur, institution, catégorie, fenêtre temporelle et limite de résultats demandés :

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

limits:
  max_results_per_query: 20
  days_back: 7

state:
  path: outputs/arxiv_tracker/state.json

email:
  enabled: false

Exécutez ensuite :

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

Si l'utilisateur souhaite uniquement une recherche unique au lieu d'un suivi à long terme, l'agent peut utiliser des chemins temporaires :

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

Gestion de la sortie

La commande scan :

1. Affiche le digest sur la sortie standard (stdout).
2. Écrit le digest dans un fichier Markdown lorsque --output est fourni.

L'agent doit lire la sortie standard ou le fichier --output, puis adapter le Markdown pour la surface cible, telle que le terminal, une interface web, un e-mail, Feishu, DingTalk, Slack, Discord ou une autre interface de chat.

Planification

Ce dépôt ne dépend d'aucun framework d'agent spécifique. Pour des exécutions périodiques, déclenchez la commande scan depuis n'importe quel planificateur ou environnement d'automatisation, comme :

• OpenClaw ou un autre environnement d'exécution d'agent compatible avec les compétences.
• Claude Code ou un autre agent de codage local.
• Un autre planificateur d'agent.
• cron.
• GitHub Actions.
• Un planificateur personnalisé.

Le planificateur doit uniquement exécuter la commande scan et livrer le digest Markdown généré via son propre canal de notification.

Règles de sécurité

• Le dépôt public fournit uniquement config.example.yaml.
• Ne commitez pas de fichiers config.yaml personnels.
• La notification par e-mail est désactivée par défaut.
• Si l'e-mail est activé, le nom d'utilisateur SMTP et le mot de passe d'application doivent résider uniquement dans un fichier de configuration local.
• Les fichiers de configuration locaux doivent être ignorés par git.
• N'exposez pas les mots de passe d'application e-mail, clés API, cookies ou jetons dans les invites, journaux, problèmes GitHub ou sorties publiques.