Descubrimiento de Documentación vía Scripts
Resumen
Descubrimiento de documentación basado en scripts usando el estándar llms.txt.
Ejecuta scripts para manejar el flujo de trabajo completo - sin necesidad de construir URLs manualmente.
Flujo de Trabajo Principal
SIEMPRE ejecuta los scripts en este orden:
# 1. DETECTAR tipo de consulta (específica de tema vs general)
node scripts/detect-topic.js "<consulta del usuario>"
# 2. OBTENER documentación usando la salida del script
node scripts/fetch-docs.js "<consulta del usuario>"
# 3. ANALIZAR resultados (si se devuelven múltiples URLs)
cat llms.txt | node scripts/analyze-llms-txt.js -
Los scripts manejan automáticamente la construcción de URLs, cadenas de fallback y el manejo de errores.
Scripts
detect-topic.js - Clasifica el tipo de consulta
- Identifica consultas específicas de tema vs generales
- Extrae el nombre de la librería + palabra clave del tema
- Devuelve JSON:
{topic, library, isTopicSpecific} - Ejecución de cero tokens
fetch-docs.js - Recupera documentación
- Construye URLs de context7.com automáticamente
- Maneja fallback: tema → general → error
- Muestra el contenido de llms.txt o un mensaje de error
- Ejecución de cero tokens
analyze-llms-txt.js - Procesa llms.txt
- Categoriza URLs (críticas/importantes/suplementarias)
- Recomienda distribución de agentes (1 agente, 3 agentes, 7 agentes, por fases)
- Devuelve JSON con la estrategia
- Ejecución de cero tokens
Referencias de Flujo de Trabajo
Búsqueda Específica de Tema - Ruta más rápida (10-15s)
Búsqueda General de Librería - Cobertura completa (30-60s)
Análisis de Repositorio - Estrategia de fallback
Referencias
patrones-context7.md - Patrones de URL, repositorios conocidos
errores.md - Manejo de errores, estrategias de fallback
avanzado.md - Casos extremos, versionado, multilenguaje
Principios de Ejecución
- Scripts primero - Ejecuta scripts en lugar de construir URLs manualmente
- Sin sobrecarga de tokens - Los scripts se ejecutan sin cargar contexto
- Fallback automático - Los scripts manejan cadenas tema → general → error
- Divulgación progresiva - Carga flujos de trabajo/referencias solo cuando sea necesario
- Distribución de agentes - Los scripts recomiendan una estrategia de agentes paralelos
Inicio Rápido
Consulta de tema: "¿Cómo uso el selector de fecha en shadcn?"
node scripts/detect-topic.js "<consulta>" # → {topic, library, isTopicSpecific}
node scripts/fetch-docs.js "<consulta>" # → 2-3 URLs
# Leer URLs con WebFetch
Consulta general: "Documentación para Next.js"
node scripts/detect-topic.js "<consulta>" # → {isTopicSpecific: false}
node scripts/fetch-docs.js "<consulta>" # → 8+ URLs
cat llms.txt | node scripts/analyze-llms-txt.js - # → {totalUrls, distribution}
# Desplegar agentes según recomendación
Entorno
Los scripts cargan .env: process.env > .opencode/skills/docs-seeker/.env > .opencode/skills/.env > .opencode/.env
Consulta .env.example para opciones de configuración.