Découverte de Documentation via Scripts
Vue d'ensemble
Découverte de documentation orientée scripts utilisant le standard llms.txt.
Exécutez des scripts pour gérer l'ensemble du flux de travail - aucune construction manuelle d'URL nécessaire.
Flux de travail principal
Exécutez TOUJOURS les scripts dans cet ordre :
# 1. DÉTECTER le type de requête (spécifique à un sujet ou générale)
node scripts/detect-topic.js "<requête utilisateur>"
# 2. RÉCUPÉRER la documentation en utilisant le résultat du script
node scripts/fetch-docs.js "<requête utilisateur>"
# 3. ANALYSER les résultats (si plusieurs URLs renvoyées)
cat llms.txt | node scripts/analyze-llms-txt.js -
Les scripts gèrent automatiquement la construction d'URL, les chaînes de repli et la gestion des erreurs.
Scripts
detect-topic.js - Classifier le type de requête
- Identifie les requêtes spécifiques à un sujet vs générales
- Extrait le nom de la bibliothèque + le mot-clé du sujet
- Retourne du JSON :
{topic, library, isTopicSpecific} - Exécution sans surcharge contextuelle (zero-token)
fetch-docs.js - Récupérer la documentation
- Construit automatiquement les URLs context7.com
- Gère le repli : sujet → général → erreur
- Affiche le contenu llms.txt ou un message d'erreur
- Exécution sans surcharge contextuelle
analyze-llms-txt.js - Traiter le fichier llms.txt
- Catégorise les URLs (critique/important/supplémentaire)
- Recommande la distribution d'agents (1 agent, 3 agents, 7 agents, par phases)
- Retourne du JSON avec la stratégie
- Exécution sans surcharge contextuelle
Références de flux de travail
Recherche spécifique à un sujet - Chemin le plus rapide (10-15s)
Recherche générale de bibliothèque - Couverture complète (30-60s)
Analyse de dépôt - Stratégie de repli
Références
context7-patterns.md - Modèles d'URL, dépôts connus
errors.md - Gestion des erreurs, stratégies de repli
advanced.md - Cas particuliers, versionnage, multilangue
Principes d'exécution
- Scripts d'abord - Exécutez les scripts plutôt que de construire les URLs manuellement
- Surcharge contextuelle nulle - Les scripts s'exécutent sans chargement de contexte
- Repli automatique - Les scripts gèrent les chaînes sujet → général → erreur
- Divulgation progressive - Chargez les flux de travail/références uniquement lorsque nécessaire
- Distribution d'agents - Les scripts recommandent une stratégie d'agents parallèles
Démarrage rapide
Requête sur un sujet : "Comment utiliser le sélecteur de date dans shadcn ?"
node scripts/detect-topic.js "<requête>" # → {topic, library, isTopicSpecific}
node scripts/fetch-docs.js "<requête>" # → 2-3 URLs
# Lire les URLs avec WebFetch
Requête générale : "Documentation pour Next.js"
node scripts/detect-topic.js "<requête>" # → {isTopicSpecific: false}
node scripts/fetch-docs.js "<requête>" # → 8+ URLs
cat llms.txt | node scripts/analyze-llms-txt.js - # → {totalUrls, distribution}
# Déployer les agents selon la recommandation
Environnement
Les scripts chargent .env : process.env > .claude/skills/docs-seeker/.env > .claude/skills/.env > .claude/.env
Consultez .env.example pour les options de configuration.