Découverte de Documentation via Scripts
Aperçu
Découverte de documentation axée sur les 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 vs générale)
node scripts/detect-topic.js "<requête utilisateur>"
# 2. RÉCUPÉRER la documentation en utilisant la sortie du script
node scripts/fetch-docs.js "<requête utilisateur>"
# 3. ANALYSER les résultats (si plusieurs URLs retournées)
cat llms.txt | node scripts/analyze-llms-txt.js -
Les scripts gèrent automatiquement la construction des URLs, 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 à zéro token
fetch-docs.js – Récupérer la documentation
- Construit automatiquement les URLs context7.com
- Gère le repli : sujet → général → erreur
- Produit le contenu llms.txt ou un message d'erreur
- Exécution à zéro token
analyze-llms-txt.js – Traiter le fichier llms.txt
- Catégorise les URLs (critique/important/supplémentaire)
- Recommande une distribution d'agents (1 agent, 3 agents, 7 agents, par phases)
- Retourne du JSON avec la stratégie
- Exécution à zéro token
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 limites, versioning, multi-langue
Principes d'Exécution
- Scripts d'abord – Exécutez les scripts au lieu de construire manuellement les URLs
- Surcharge zéro token – 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 workflows/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 thématique : « Comment utiliser un 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.