Dokumentations-Lookup (Context7)

Was macht Dokumentations-Lookup (Context7)?

Wenn der Nutzer nach Bibliotheken, Frameworks oder APIs fragt, rufe die aktuelle Dokumentation über den Context7 MCP ab (Tools resolve-library-id und query-docs), anstatt dich auf Trainingsdaten zu verlassen.

Kernkonzepte

• Context7: MCP-Server, der Live-Dokumentation bereitstellt; verwende ihn anstelle von Trainingsdaten für Bibliotheken und APIs.
• resolve-library-id: Gibt Context7-kompatible Bibliotheks-IDs zurück (z. B. /vercel/next.js) aus einem Bibliotheksnamen und einer Abfrage.
• query-docs: Ruft Dokumentationen und Code-Snippets für eine bestimmte Bibliotheks-ID und Frage ab. Rufe immer zuerst resolve-library-id auf, um eine gültige Bibliotheks-ID zu erhalten.

Wann verwenden

Aktiviere den Skill, wenn der Nutzer:

• Einrichtungs- oder Konfigurationsfragen stellt (z. B. "Wie konfiguriere ich Next.js Middleware?")
• Code anfordert, der von einer Bibliothek abhängt ("Schreibe eine Prisma-Abfrage für...")
• API- oder Referenzinformationen benötigt ("Welche Supabase Auth-Methoden gibt es?")
• Bestimmte Frameworks oder Bibliotheken nennt (React, Vue, Svelte, Express, Tailwind, Prisma, Supabase usw.)

Verwende diesen Skill immer dann, wenn die Anfrage von akkuratem, aktuellem Verhalten einer Bibliothek, eines Frameworks oder einer API abhängt. Gilt für alle Umgebungen, die den Context7 MCP konfiguriert haben (z. B. Claude Code, Cursor, Codex).

So funktioniert es

Schritt 1: Bibliotheks-ID auflösen

Rufe das MCP-Tool resolve-library-id auf mit:

• libraryName: Der Bibliotheks- oder Produktname aus der Frage des Nutzers (z. B. Next.js, Prisma, Supabase).
• query: Die vollständige Frage des Nutzers. Dies verbessert die Relevanzbewertung der Ergebnisse.

Du musst eine Context7-kompatible Bibliotheks-ID (Format /org/project oder /org/project/version) erhalten, bevor du Dokumentationen abfragst. Rufe query-docs nicht ohne eine gültige Bibliotheks-ID aus diesem Schritt auf.

Schritt 2: Die beste Übereinstimmung auswählen

Wähle aus den Auflösungsergebnissen eines aus, indem du Folgendes berücksichtigst:

• Namensübereinstimmung: Bevorzuge die exakte oder die nächstbeste Übereinstimmung mit dem, wonach der Nutzer gefragt hat.
• Benchmark-Score: Höhere Werte weisen auf eine bessere Dokumentationsqualität hin (100 ist der Höchstwert).
• Quellenreputation: Bevorzuge nach Möglichkeit eine hohe oder mittlere Reputation.
• Version: Wenn der Nutzer eine Version angegeben hat (z. B. "React 19", "Next.js 15"), bevorzuge eine versionsspezifische Bibliotheks-ID, falls aufgeführt (z. B. /org/project/v1.2.0).

Schritt 3: Dokumentation abrufen

Rufe das MCP-Tool query-docs auf mit:

• libraryId: Die ausgewählte Context7-Bibliotheks-ID aus Schritt 2 (z. B. /vercel/next.js).
• query: Die spezifische Frage oder Aufgabe des Nutzers. Sei präzise, um relevante Snippets zu erhalten.

Einschränkung: Rufe query-docs (oder resolve-library-id) nicht öfter als 3 Mal pro Frage auf. Falls die Antwort nach 3 Aufrufen unklar bleibt, gib die Unsicherheit an und verwende die besten verfügbaren Informationen, anstatt zu raten.

Schritt 4: Dokumentation verwenden

• Beantworte die Frage des Nutzers mit den abgerufenen, aktuellen Informationen.
• Füge bei Bedarf relevante Codebeispiele aus der Dokumentation hinzu.
• Zitiere die Bibliothek oder Version, wenn es relevant ist (z. B. "In Next.js 15...").

Beispiele

Beispiel: Next.js Middleware

1. Rufe resolve-library-id auf mit libraryName: "Next.js", query: "Wie richte ich Next.js Middleware ein?".
2. Wähle aus den Ergebnissen die beste Übereinstimmung (z. B. /vercel/next.js) anhand von Name und Benchmark-Score aus.
3. Rufe query-docs auf mit libraryId: "/vercel/next.js", query: "Wie richte ich Next.js Middleware ein?".
4. Verwende die zurückgegebenen Snippets und Texte, um zu antworten; füge bei Bedarf ein minimales middleware.ts-Beispiel aus der Dokumentation hinzu.

Beispiel: Prisma-Abfrage

1. Rufe resolve-library-id auf mit libraryName: "Prisma", query: "Wie führe ich eine Abfrage mit Relationen durch?".
2. Wähle die offizielle Prisma-Bibliotheks-ID (z. B. /prisma/prisma).
3. Rufe query-docs auf mit dieser libraryId und der Abfrage.
4. Gib das Prisma Client-Muster (z. B. include oder select) mit einem kurzen Code-Snippet aus der Dokumentation zurück.

Beispiel: Supabase Auth-Methoden

1. Rufe resolve-library-id auf mit libraryName: "Supabase", query: "Welche Auth-Methoden gibt es?".
2. Wähle die Supabase-Dokumentations-Bibliotheks-ID.
3. Rufe query-docs auf; fasse die Auth-Methoden zusammen und zeige minimale Beispiele aus der abgerufenen Dokumentation.

Best Practices

• Sei präzise: Verwende nach Möglichkeit die vollständige Frage des Nutzers als Abfrage, um eine bessere Relevanz zu erzielen.
• Versionsbewusstsein: Wenn Nutzer Versionen nennen, verwende versionsspezifische Bibliotheks-IDs aus dem Auflösungsschritt, falls verfügbar.
• Bevorzuge offizielle Quellen: Wenn mehrere Übereinstimmungen existieren, bevorzuge offizielle oder primäre Pakete gegenüber Community-Forks.
• Keine sensiblen Daten: Entferne API-Schlüssel, Passwörter, Tokens und andere Geheimnisse aus allen an Context7 gesendeten Abfragen. Behandle die Frage des Nutzers als potenziell geheimnisbehaftet, bevor du sie an resolve-library-id oder query-docs weitergibst.