Découverte de Documentation via Scripts
Aperçu
Découverte de documentation axée sur les scripts utilisant la norme llms.txt.
Exécutez des scripts pour gérer l'ensemble du workflow - aucune construction manuelle d'URL nécessaire.
Workflow 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 URL sont renvoyées)
cat llms.txt | node scripts/analyze-llms-txt.js -
Les scripts gèrent automatiquement la construction des 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 ou générales
- Extrait le nom de la bibliothèque + le mot-clé du sujet
- Renvoie du JSON :
{topic, library, isTopicSpecific} - Exécution sans jeton
fetch-docs.js - Récupérer la documentation
- Construit automatiquement les URL context7.com
- Gère le repli : sujet → général → erreur
- Affiche le contenu llms.txt ou un message d'erreur
- Exécution sans jeton
analyze-llms-txt.js - Traiter llms.txt
- Catégorise les URL (critiques/importantes/supplémentaires)
- Recommande la répartition des agents (1 agent, 3 agents, 7 agents, par phases)
- Renvoie du JSON avec stratégie
- Exécution sans jeton
Références de Workflow
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, gestion de versions, multi-langue
Principes d'Exécution
- Scripts d'abord - Exécutez les scripts au lieu de construire manuellement les URL
- Aucune surcharge de jetons - 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
- Répartition des agents - Les scripts recommandent une stratégie d'agents parallèles
Démarrage Rapide
Requête thématique : "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 > .opencode/skills/docs-seeker/.env > .opencode/skills/.env > .opencode/.env
Consultez .env.example pour les options de configuration.