O que Descoberta de Documentação via Scripts faz?
Visão Geral
Descoberta de documentação baseada em scripts usando o padrão llms.txt.
Execute scripts para lidar com todo o fluxo de trabalho - sem necessidade de construção manual de URLs.
Fluxo de Trabalho Principal
SEMPRE execute os scripts nesta ordem:
# 1. DETECTAR tipo de consulta (específica vs geral)
node scripts/detect-topic.js "<consulta do usuário>"
# 2. BUSCAR documentação usando a saída do script
node scripts/fetch-docs.js "<consulta do usuário>"
# 3. ANALISAR resultados (se múltiplas URLs forem retornadas)
cat llms.txt | node scripts/analyze-llms-txt.js -
Os scripts lidam automaticamente com a construção de URLs, cadeias de fallback e tratamento de erros.
Scripts
detect-topic.js - Classificar tipo de consulta
- Identifica consultas específicas vs. gerais
- Extrai nome da biblioteca + palavra-chave do tópico
- Retorna JSON:
{topic, library, isTopicSpecific} - Execução com zero tokens
fetch-docs.js - Recuperar documentação
- Constrói URLs context7.com automaticamente
- Gerencia fallback: tópico → geral → erro
- Gera conteúdo llms.txt ou mensagem de erro
- Execução com zero tokens
analyze-llms-txt.js - Processar llms.txt
- Categoriza URLs (críticas/importantes/suplementares)
- Recomenda distribuição de agentes (1 agente, 3 agentes, 7 agentes, por fases)
- Retorna JSON com estratégia
- Execução com zero tokens
Referências de Fluxo de Trabalho
Busca Tópica Específica - Caminho mais rápido (10-15s)
Busca Geral de Biblioteca - Cobertura abrangente (30-60s)
Análise de Repositório - Estratégia de fallback
Referências
context7-patterns.md - Padrões de URL, repositórios conhecidos
errors.md - Tratamento de erros, estratégias de fallback
advanced.md - Casos de borda, versionamento, multilíngue
Princípios de Execução
- Scripts primeiro - Execute scripts em vez de construção manual de URLs
- Overhead zero de tokens - Scripts executam sem carregamento de contexto
- Fallback automático - Scripts lidam com cadeias tópico → geral → erro
- Divulgação progressiva - Carregue fluxos de trabalho/referências apenas quando necessário
- Distribuição de agentes - Scripts recomendam estratégia paralela de agentes
Início Rápido
Consulta tópica: "Como usar o seletor de data no shadcn?"
node scripts/detect-topic.js "<consulta>" # → {topic, library, isTopicSpecific}
node scripts/fetch-docs.js "<consulta>" # → 2-3 URLs
# Leia URLs com WebFetch
Consulta geral: "Documentação do 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}
# Implante agentes conforme recomendação
Ambiente
Os scripts carregam .env: process.env > .opencode/skills/docs-seeker/.env > .opencode/skills/.env > .opencode/.env
Veja .env.example para opções de configuração.