Descoberta de Documentação via Scripts
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 de tópico 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 cuidam automaticamente da construção de URLs, cadeias de fallback e tratamento de erros.
Scripts
detect-topic.js - Classificar tipo de consulta
- Identifica consultas específicas de tópico 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
- Lida com 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, em fases)
- Retorna JSON com estratégia
- Execução com zero tokens
Referências de Fluxo de Trabalho
Pesquisa Específica de Tópico - Caminho mais rápido (10-15s)
Pesquisa 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 extremos, versionamento, multilíngue
Princípios de Execução
- Scripts primeiro - Execute scripts em vez de construir URLs manualmente
- Sobrecarga zero de tokens - Scripts são executados 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 de tópico: "Como usar date picker 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 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}
# Implante agentes conforme recomendação
Ambiente
Os scripts carregam .env: process.env > .opencode/skills/docs-seeker/.env > .opencode/skills/.env > .opencode/.env
Consulte .env.example para opções de configuração.