documentation-lookup

Documentação Lookup (Context7)

Quando o usuário perguntar sobre bibliotecas, frameworks ou APIs, busque a documentação atual via o MCP Context7 (ferramentas resolve-library-id e query-docs) em vez de depender de dados de treinamento.

Conceitos Principais

• Context7: Servidor MCP que expõe documentação ao vivo; use-o em vez de dados de treinamento para bibliotecas e APIs.
• resolve-library-id: Retorna IDs de biblioteca compatíveis com Context7 (ex: /vercel/next.js) a partir de um nome de biblioteca e consulta.
• query-docs: Busca documentação e trechos de código para um determinado ID de biblioteca e pergunta. Sempre chame resolve-library-id primeiro para obter um ID de biblioteca válido.

Quando usar

Ative quando o usuário:

• Fizer perguntas de configuração ou instalação (ex: "Como configurar o middleware do Next.js?")
• Solicitar código que depende de uma biblioteca ("Escreva uma consulta Prisma para...")
• Precisar de informações de API ou referência ("Quais são os métodos de autenticação do Supabase?")
• Mencionar frameworks ou bibliotecas específicas (React, Vue, Svelte, Express, Tailwind, Prisma, Supabase, etc.)

Use esta skill sempre que a solicitação depender do comportamento preciso e atualizado de uma biblioteca, framework ou API. Aplica-se a ambientes que tenham o MCP Context7 configurado (ex: Claude Code, Cursor, Codex).

Como funciona

Passo 1: Resolver o ID da Biblioteca

Chame a ferramenta MCP resolve-library-id com:

• libraryName: O nome da biblioteca ou produto extraído da pergunta do usuário (ex: Next.js, Prisma, Supabase).
• query: A pergunta completa do usuário. Isso melhora a relevância dos resultados.

Você deve obter um ID de biblioteca compatível com Context7 (formato /org/projeto ou /org/projeto/versão) antes de consultar a documentação. Não chame query-docs sem um ID de biblioteca válido desta etapa.

Passo 2: Selecionar a Melhor Correspondência

Dos resultados da resolução, escolha um resultado usando:

• Correspondência de nome: Prefira a correspondência exata ou a mais próxima do que o usuário perguntou.
• Pontuação de benchmark: Pontuações mais altas indicam melhor qualidade da documentação (100 é o máximo).
• Reputação da fonte: Prefira fontes Alta ou Média quando disponíveis.
• Versão: Se o usuário especificou uma versão (ex: "React 19", "Next.js 15"), prefira um ID de biblioteca específico da versão se listado (ex: /org/projeto/v1.2.0).

Passo 3: Buscar a Documentação

Chame a ferramenta MCP query-docs com:

• libraryId: O ID da biblioteca Context7 selecionado no Passo 2 (ex: /vercel/next.js).
• query: A pergunta ou tarefa específica do usuário. Seja específico para obter trechos relevantes.

Limite: não chame query-docs (ou resolve-library-id) mais de 3 vezes por pergunta. Se a resposta não estiver clara após 3 chamadas, declare a incerteza e use a melhor informação que você tem, em vez de adivinhar.

Passo 4: Usar a Documentação

• Responda à pergunta do usuário usando as informações atuais obtidas.
• Inclua exemplos de código relevantes da documentação quando útil.
• Cite a biblioteca ou versão quando for importante (ex: "No Next.js 15...").

Exemplos

Exemplo: Middleware Next.js

1. Chame resolve-library-id com libraryName: "Next.js", query: "Como configuro o middleware do Next.js?".
2. Dos resultados, escolha a melhor correspondência (ex: /vercel/next.js) pelo nome e pontuação de benchmark.
3. Chame query-docs com libraryId: "/vercel/next.js", query: "Como configuro o middleware do Next.js?".
4. Use os trechos e texto retornados para responder; inclua um exemplo mínimo de middleware.ts da documentação se relevante.

Exemplo: Consulta Prisma

1. Chame resolve-library-id com libraryName: "Prisma", query: "Como faço uma consulta com relações?".
2. Selecione o ID da biblioteca oficial do Prisma (ex: /prisma/prisma).
3. Chame query-docs com esse libraryId e a consulta.
4. Retorne o padrão do Prisma Client (ex: include ou select) com um pequeno trecho de código da documentação.

Exemplo: Métodos de autenticação Supabase

1. Chame resolve-library-id com libraryName: "Supabase", query: "Quais são os métodos de autenticação?".
2. Escolha o ID da biblioteca da documentação do Supabase.
3. Chame query-docs; resuma os métodos de autenticação e mostre exemplos mínimos da documentação obtida.

Melhores Práticas

• Seja específico: Use a pergunta completa do usuário como consulta sempre que possível para melhor relevância.
• Consciência de versão: Quando os usuários mencionarem versões, use IDs de biblioteca específicos da versão da etapa de resolução quando disponíveis.
• Prefira fontes oficiais: Quando houver múltiplas correspondências, prefira pacotes oficiais ou primários em vez de forks da comunidade.
• Sem dados sensíveis: Remova chaves de API, senhas, tokens e outros segredos de qualquer consulta enviada ao Context7. Trate a pergunta do usuário como potencialmente contendo segredos antes de passá-la para resolve-library-id ou query-docs.