Descubrimiento de Documentación Mediante Scripts
Resumen
Descubrimiento de documentación basado en scripts utilizando el estándar llms.txt.
Ejecuta scripts para manejar todo el flujo de trabajo, 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 respaldo y manejo de errores.
Scripts
detect-topic.js - Clasificar el tipo de consulta
- Identifica consultas específicas de tema vs generales
- Extrae el nombre de la biblioteca + palabra clave del tema
- Devuelve JSON:
{topic, library, isTopicSpecific} - Ejecución de cero tokens
fetch-docs.js - Recuperar documentación
- Construye URLs de context7.com automáticamente
- Maneja respaldo: tema → general → error
- Genera contenido llms.txt o mensaje de error
- Ejecución de cero tokens
analyze-llms-txt.js - Procesar llms.txt
- Categoriza URLs (críticas/importantes/secundarias)
- 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 Biblioteca - Cobertura completa (30-60s)
Análisis de Repositorio - Estrategia de respaldo
Referencias
patrones-context7.md - Patrones de URL, repositorios conocidos
errores.md - Manejo de errores, estrategias de respaldo
avanzado.md - Casos límite, versionado, multilingüe
Principios de Ejecución
- Primero los scripts - Ejecuta scripts en lugar de construir URLs manualmente
- Cero gastos de tokens - Los scripts se ejecutan sin cargar contexto
- Respaldo automático - Los scripts manejan las cadenas tema → general → error
- Divulgación progresiva - Carga flujos de trabajo/referencias solo cuando sea necesario
- Distribución de agentes - Los scripts recomiendan estrategia de agentes paralelos
Inicio Rápido
Consulta de tema: "¿Cómo usar 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 de 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 la 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.