Découverte de Documentation via Scripts
Vue d'ensemble
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 ou général)
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 retourné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 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 consommation de jetons (zero-token)
fetch-docs.js — Récupérer la documentation
- Construit automatiquement les URL context7.com
- Gère le repli : sujet → général → erreur
- Produit le contenu llms.txt ou un message d'erreur
- Exécution sans consommation de jetons (zero-token)
analyze-llms-txt.js — Traiter llms.txt
- Catégorise les URL (critique/important/supplémentaire)
- Recommande la distribution des agents (1 agent, 3 agents, 7 agents, par phases)
- Retourne du JSON avec une stratégie
- Exécution sans consommation de jetons (zero-token)
Références des flux de travail
Recherche par 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, multilangue
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 flux de travail/références uniquement quand nécessaire
- Distribution des 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 URL
# Lire les URL 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+ URL
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
Voir .env.example pour les options de configuration.