Consulta de Documentação (Context7)

O que Consulta de Documentação (Context7) faz?

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

Conceitos Principais

• Context7: Servidor MCP que expõe documentação ao vivo; use-o em vez dos 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 configuro o middleware do Next.js?")
• Solicitar código que dependa 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íficos (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 harnesses que tenham o MCP Context7 configurado (ex: Claude Code, Cursor, Codex).

Como funciona

Etapa 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.

Etapa 2: Selecionar a Melhor Correspondência

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

• Correspondência de nome: Prefira correspondência exata ou a mais próxima do que o usuário perguntou.
• Pontuação de referência: Pontuações mais altas indicam melhor qualidade da documentação (100 é o máximo).
• Reputação da fonte: Prefira fontes com reputação 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).

Etapa 3: Buscar a Documentação

Chame a ferramenta MCP query-docs com:

• libraryId: O ID de biblioteca Context7 selecionado na Etapa 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 disponível, em vez de adivinhar.

Etapa 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 relevante (ex: "No Next.js 15...").

Exemplos

Exemplo: Middleware no 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 referência.
3. Chame query-docs com libraryId: "/vercel/next.js", query: "Como configuro o middleware do Next.js?".
4. Use os trechos e o 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 fazer consultas 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 do 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 de 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.