ARRÊTEZ. LISEZ L'INTÉGRALITÉ DE CE SKILL.MD AVANT D'APPELER UN POINT D'ACCÈS.
Compétence arXiv
Recherchez sur arXiv et extrayez des connaissances en mémoire.
Commandes
| Commande | Description |
|---|---|
search | Trouver des articles (retourne les résumés pour triage) |
learn | Extraire des connaissances en mémoire |
download | Télécharger l'article en HTML par défaut ; les fichiers de sortie sont nommés à partir du titre de l'article |
OBLIGATOIRE : Génération de Contexte Dynamique
NON-NÉGOCIABLE : Avant toute opération arXiv, l'agent DOIT générer un fichier de contexte dynamique qui capture les objectifs de collaboration actuels.
Pourquoi C'est Requis
Sans contexte dynamique :
- La recherche retourne des articles tangentiellement liés
- Le triage des résumés manque de critères de pertinence clairs
- Les connaissances extraites sont génériques ("Que dit l'article sur X ?")
Avec contexte dynamique :
- La recherche est ciblée sur des besoins d'implémentation spécifiques
- L'évaluation des résumés a des critères d'acceptation/rejet clairs
- Les connaissances extraites sont exploitables ("Comment implémenter X en code")
Flux de Travail : Découverte d'Articles Axée sur le Contexte
0. CONTEXTE → Générer le contexte dynamique à partir de la conversation (OBLIGATOIRE)
1. RECHERCHE → Utiliser le contexte pour trouver des articles pertinents
2. TRIAGE → Évaluer les résumés par rapport aux objectifs du contexte
3. DÉCISION → L'utilisateur choisit les articles à extraire
4. APPRENTISSAGE → Extraire avec le contexte pour des morceaux de connaissances ciblés
Étape 0 : Générer le Contexte Dynamique (OBLIGATOIRE)
Avant de rechercher, l'agent DOIT créer /tmp/arxiv_context.md avec :
# Contexte de Recherche : [Votre Objectif Spécifique]
## Ce Que Nous Construisons
[Décrivez la fonctionnalité/système spécifique, ex. "Théorie de l'Esprit pour l'agent Horus"]
## État Actuel
[Ce qui existe déjà, ce qui est implémenté, ce que nous avons]
## Ce Dont Nous Avons Besoin des Articles
1. [Question spécifique 1, ex. "Comment représenter la confiance dans les croyances comme structure de données"]
2. [Question spécifique 2, ex. "Quand déclencher la réflexion contrefactuelle"]
3. [Question spécifique 3, ex. "Algorithme pour mettre à jour les croyances en cas de contradiction"]
## Termes de Recherche à Essayer
- [terme 1]
- [terme 2]
## Critères de Pertinence pour le Triage des Résumés
- HAUT : Articles qui répondent directement à [besoin spécifique]
- MOYEN : Articles avec des techniques connexes pouvant être adaptées
- BAS : Liés tangentiellement, sauter sauf si rien de mieux
## Focus de l'Extraction des Connaissances
- Extraire : [quel type de connaissances, ex. "algorithmes, structures de données, règles de mise à jour"]
- Ignorer : [ce qu'il faut ignorer, ex. "métriques d'évaluation, descriptions de jeux de données, travaux futurs"]
## Préférence de Format de Sortie
Formuler comme des problèmes d'implémentation, pas des résumés :
- MAUVAIS : "Que dit l'article sur X ?"
- BON : "Comment implémenter X ? Quel motif de code ?"
Étape 1 : Rechercher Avec le Contexte
Après avoir créé le contexte, utilisez-le pour guider la recherche :
# Recherche guidée par les objectifs du contexte
./run.sh search -q "theory of mind BDI agent belief tracking" -n 10
Étape 2 : Trier Contre le Contexte
Évaluez chaque résumé par rapport aux critères de pertinence du contexte :
## Articles Trouvés - Évaluation Par Rapport aux Objectifs du Contexte
### 1. **Titre de l'article** (arXiv:XXXX.XXXXX)
> [Résumé]
**Par rapport au contexte :**
- Répond à l'objectif 1 (représentation des croyances) : OUI - décrit la structure de dictée BDI
- Répond à l'objectif 2 (réflexion contrefactuelle) : NON
- **Verdict : HAUT** - répond directement à notre question de structure de données
### 2. **Titre de l'article** (arXiv:XXXX.XXXXX)
> [Résumé]
**Par rapport au contexte :**
- Répond à l'objectif 1 : NON
- Répond à l'objectif 2 : OUI - décrit les conditions de déclenchement de la réflexion
- **Verdict : HAUT** - répond directement à notre question d'algorithme
---
Quels articles dois-je extraire ?
Étape 3 : Extraire Avec le Fichier de Contexte
Passez le fichier de contexte à learn pour une extraction ciblée :
./run.sh learn 2501.15355 --scope persona-research --context-file /tmp/arxiv_context.md
Ne PAS procéder sans confirmation de l'utilisateur sur la sélection des articles.
search - Trouver des Articles
./run.sh search -q "agent memory" -n 5
Retourne les articles avec résumés complets pour un triage rapide.
| Option | Description |
|---|---|
-q | Requête de recherche (obligatoire) |
-n | Nombre max de résultats (défaut : 10) |
-c | Filtre de catégorie (ex. cs.LG) |
-m | Articles des N derniers mois |
--smart | L'IA traduit la requête en langage naturel |
learn - Extraire des Connaissances
./run.sh learn 2601.08058 --scope memory
Pipeline complet : téléchargement → profilage → extraction → Q&A → interview → stockage → vérification des arêtes.
| Option | Description |
|---|---|
--scope | Portée mémoire (obligatoire) |
--context | Focus domaine pour la pertinence |
--dry-run | Aperçu sans stockage |
--skip-interview | Acceptation automatique des recommandations |
--accurate | Forcer l'extraction PDF + VLM |
--mode | Mode d'entrevue : auto, html, tui (défaut : auto) |
Mode d'Extraction (HTML en Priorité)
NOUVEAU : La commande learn utilise désormais l'extraction HTML en priorité par défaut :
- Télécharge le HTML depuis ar5iv.org (articles arXiv convertis en HTML propre)
- Exécute une vérification de profil rapide (compte les figures/tableaux)
- Achemine vers le mode d'extraction approprié
arxiv learn <id>
│
├── mode rapide (défaut) ──► ar5iv HTML ──► extracteur HTML
│ - La plupart des articles de recherche (parité d'extraction 100%)
│ - Contenu riche en texte (pas de problèmes de colonnes PDF)
│
└── mode précis ──► arXiv PDF ──► extracteur PDF + VLM
- Articles où les figures sont critiques
- Tableaux complexes avec valeurs précises
- Utilisation : indicateur --accurate
Pourquoi HTML en Priorité ?
| Aspect | HTML (ar5iv) | |
|---|---|---|
| Qualité d'extraction | Parité 100% | ~87% (problèmes de détection de colonnes) |
| Vitesse | Rapide (~5s) | Plus lent (~30s-2min) |
| Légendes de figures | Incluses | Nécessite VLM |
| Rendu mathématique | MathML préservé | Approximation textuelle |
| Problèmes de mise en page | Aucun | Problèmes avec colonnes doubles |
ar5iv.org convertit le code LaTeX des articles arXiv en HTML sémantique avec des équations MathML et une structure appropriée. Cela élimine les problèmes d'extraction PDF.
Quand Utiliser --accurate
| Type de Contenu | Mode Recommandé | Pourquoi |
|---|---|---|
| La plupart des articles de recherche | défaut (HTML) | Le texte et les légendes suffisent |
| Articles de synthèse | défaut (HTML) | Couverture large, les figures exactes ne sont pas critiques |
| Articles avec diagrammes critiques | --accurate | Quand le contenu visuel est le sujet |
| Articles avec tableaux de données complexes | --accurate | Quand les nombres précis sont importants |
# Défaut : extraction HTML (rapide, fiable)
./run.sh learn 2601.10025 --scope persona-research
# Forcer le mode précis pour les articles riches en figures
./run.sh learn 2501.15355 --scope tom-research --accurate
Routage Basé sur le Profil
La compétence profile automatiquement le HTML téléchargé pour suggérer un mode d'extraction :
- < 20 figures ET < 10 tableaux : Utilise HTML (mode rapide)
- > 20 figures OU > 10 tableaux : Suggère le mode précis (ou utilisez
--accurate)
La sortie du profil apparaît dans les logs :
Profil : 12 figures, 4 tableaux → Utilisation de l'extraction HTML (mode rapide)
Parcours Heureux
# 1. Recherche - obtenir les résumés
./run.sh search -q "agent memory systems" -n 5
# 2. STOP - discuter des résumés avec l'utilisateur, évaluer la pertinence
# 3. Apprendre - extraire les articles sélectionnés par l'utilisateur (extraction HTML par défaut)
./run.sh learn 2601.10702 --scope memory --context "agent systems"
Exemples
Enquête de Recherche (extraction HTML - défaut)
./run.sh learn 2601.10025 --scope persona-research --context "LLM personality"
Article avec Figures Critiques (mode précis)
./run.sh learn 2501.15355 --scope tom-research --context "BDI architecture" --accurate
Simulation d'Exécution d'abord
# Aperçu de ce qui serait extrait
./run.sh learn 2601.10025 --scope test --dry-run
Téléchargement HTML Uniquement
# Télécharger le HTML ar5iv pour inspection manuelle (défaut ; nom de fichier basé sur le titre)
./run.sh download -i 2501.15355
# Télécharger le PDF uniquement si nécessaire
./run.sh download -i 2501.15355 --format pdf
Traitement par Lots (Parallèle)
# Traiter plusieurs articles en parallèle (défaut : 2 concurrents)
./run.sh batch 2501.15355 2502.14171 2310.10701 --scope tom-research --context-file /tmp/context.md
# Augmenter le parallélisme pour un traitement plus rapide
./run.sh batch 2501.15355 2502.14171 2310.10701 --scope research --parallel 3
# Simulation d'exécution pour prévisualiser
./run.sh batch 2501.15355 2502.14171 --scope test --dry-run
| Option | Description |
|---|---|
--parallel N | Nombre max d'articles à traiter simultanément (défaut : 2) |
--context-file | Fichier de contexte riche pour extraction ciblée |
--skip-interview | Acceptation automatique (défaut pour le traitement par lots) |
--dry-run | Aperçu sans stockage |
Note : Le parallélisme recommandé est de 2-3 articles. Des valeurs plus élevées peuvent atteindre les limites de débit de l'API.
Erreurs Courantes
ERRONÉ : Rechercher sans d'abord créer le contexte
./run.sh search -q "agent memory" -n 10
CORRECT : Générer /tmp/arxiv_context.md PUIS rechercher
# 1. Écrire le fichier de contexte avec des objectifs spécifiques et des critères de pertinence
# 2. Ensuite, rechercher guidée par le contexte
./run.sh search -q "agent memory BDI belief tracking" -n 10
ERRONÉ : Extraire des articles sans confirmation de l'utilisateur
# L'agent extrait automatiquement les 10 résultats de recherche
./run.sh learn 2501.15355 --scope research
./run.sh learn 2502.14171 --scope research
CORRECT : Présenter les résumés, laisser l'utilisateur choisir, puis extraire
./run.sh search -q "agent memory" -n 10
# STOP - discuter des résumés avec l'utilisateur, évaluer la pertinence
# L'utilisateur sélectionne les articles 2 et 5
./run.sh learn 2501.15355 --scope research --context-file /tmp/arxiv_context.md
ERRONÉ : Utiliser --accurate pour des articles riches en texte
./run.sh learn 2601.10025 --scope research --accurate # perd du temps avec l'extraction PDF
CORRECT : Mode HTML par défaut pour la plupart des articles, --accurate uniquement pour ceux riches en figures
./run.sh learn 2601.10025 --scope research # HTML est plus rapide et plus fiable
Dépendances
| Composant | URL | Objectif |
|---|---|---|
| ar5iv.org | https://ar5iv.org | Conversion LaTeX en HTML pour les articles arXiv |
| compétence extractor | (compétence sœur) | Extraction de contenu HTML/PDF |
| compétence qra | (compétence sœur) | Génération de paires Q&A à partir de texte |
Note de reprise après échec de formation QRA (2026-09-14)
Observé lors de la recherche de formation qra : download --format html a échoué lorsque
l'API de métadonnées arXiv renvoyait 429 ou expirait avant l'étape de téléchargement HTML/PDF.
Le CLI traite désormais la recherche de métadonnées comme facultative pour les ID d'article directs.
Si les métadonnées échouent, il construit des URL de repli directes et essaie, dans l'ordre :
https://arxiv.org/html/<id-avec-version>https://arxiv.org/html/<id-base>https://ar5iv.org/abs/<id-base>https://ar5iv.labs.arxiv.org/html/<id-base>
Un échec des métadonnées doit apparaître dans warnings[], pas dans errors[], lorsqu'une de
ces URL de contenu réussit.