J4NN0/skills

Dokumentationsabfrage

Rufe die aktuelle Dokumentation und Codebeispiele für jede Bibliothek mit der Context7 CLI ab.

Stelle sicher, dass die CLI auf dem neuesten Stand ist, bevor du Befehle ausführst:

npm install -g ctx7@latest

Oder führe sie direkt ohne Installation aus:

npx ctx7@latest <command>

Arbeitsablauf

Zweistufiger Prozess: Löse den Bibliotheksnamen in eine ID auf, frage dann die Dokumentation mit dieser ID ab.

# Schritt 1: Bibliotheks-ID auflösen
ctx7 library <name> <query>

# Schritt 2: Dokumentation abfragen
ctx7 docs <libraryId> <query>

Du MUSST zuerst ctx7 library aufrufen, um eine gültige Bibliotheks-ID zu erhalten, es sei denn, der Benutzer gibt explizit eine Bibliotheks-ID im Format /org/project oder /org/project/version an.

WICHTIG: Führe diese Befehle nicht mehr als 3 Mal pro Frage aus. Wenn du nach 3 Versuchen nicht findest, was du brauchst, verwende das beste Ergebnis, das du hast.

Schritt 1: Eine Bibliothek auflösen

Löst einen Paket-/Produktnamen in eine Context7-kompatible Bibliotheks-ID auf und gibt passende Bibliotheken zurück.

ctx7 library react "Wie man useEffect mit asynchronen Operationen aufräumt"
ctx7 library nextjs "Wie man App Router mit Middleware einrichtet"
ctx7 library prisma "Wie man 1-zu-n-Beziehungen mit kaskadierendem Löschen definiert"

Übergib immer ein query-Argument – es ist erforderlich und beeinflusst direkt die Ergebnisranking. Verwende die Absicht des Benutzers, um die Abfrage zu formulieren, was hilft, wenn mehrere Bibliotheken einen ähnlichen Namen teilen. Gib keine sensiblen oder vertraulichen Informationen wie API-Schlüssel, Passwörter, Anmeldedaten, personenbezogene Daten oder proprietären Code in deine Abfrage ein.

Ergebnisfelder

Jedes Ergebnis enthält:

• Bibliotheks-ID – Context7-kompatibler Bezeichner (Format: /org/project)
• Name – Bibliotheks- oder Paketname
• Beschreibung – Kurze Zusammenfassung
• Code-Snippets – Anzahl der verfügbaren Codebeispiele
• Quell-Reputation – Autoritätsindikator (Hoch, Mittel, Niedrig oder Unbekannt)
• Benchmark-Score – Qualitätsindikator (100 ist die höchste Punktzahl)
• Versionen – Liste der verfügbaren Versionen, falls vorhanden. Verwende eine dieser Versionen, wenn der Benutzer eine Version in seiner Abfrage angibt. Das Format ist /org/project/version.

Auswahlprozess

1. Analysiere die Abfrage, um zu verstehen, nach welcher Bibliothek/dem Paket der Benutzer sucht.
2. Wähle die relevanteste Übereinstimmung basierend auf:
   • Namensähnlichkeit zur Abfrage (exakte Übereinstimmungen werden priorisiert)
   • Beschreibungsrelevanz für die Absicht der Abfrage
   • Dokumentationsabdeckung (priorisiere Bibliotheken mit höheren Code-Snippet-Anzahlen)
   • Quell-Reputation (berücksichtige Bibliotheken mit hoher oder mittlerer Reputation als autoritativer)
   • Benchmark-Score (höher ist besser, 100 ist das Maximum)
3. Wenn mehrere gute Übereinstimmungen existieren, bestätige dies, aber fahre mit der relevantesten fort.
4. Wenn keine guten Übereinstimmungen existieren, teile dies klar mit und schlage Verfeinerungen der Abfrage vor.
5. Bei mehrdeutigen Abfragen fordere vor dem Fortfahren mit einer bestmöglichen Übereinstimmung eine Klärung an.

Versionsspezifische IDs

Wenn der Benutzer eine bestimmte Version erwähnt, verwende eine versionsspezifische Bibliotheks-ID:

# Allgemein (letzter indexierter Stand)
ctx7 docs /vercel/next.js "Wie man App Router einrichtet"

# Versionsspezifisch
ctx7 docs /vercel/next.js/v14.3.0-canary.87 "Wie man App Router einrichtet"

Die verfügbaren Versionen sind in der Ausgabe von ctx7 library aufgelistet. Verwende die nächstgelegene Übereinstimmung mit dem, was der Benutzer angegeben hat.

Schritt 2: Dokumentation abfragen

Ruft aktuelle Dokumentation und Codebeispiele für die aufgelöste Bibliothek ab.

ctx7 docs /facebook/react "Wie man useEffect mit asynchronen Operationen aufräumt"
ctx7 docs /vercel/next.js "Wie man Authentifizierungs-Middleware zum App Router hinzufügt"
ctx7 docs /prisma/prisma "Wie man 1-zu-n-Beziehungen mit kaskadierendem Löschen definiert"

Gute Abfragen schreiben

Die Abfrage beeinflusst direkt die Qualität der Ergebnisse. Sei spezifisch und füge relevante Details hinzu. Gib keine sensiblen oder vertraulichen Informationen wie API-Schlüssel, Passwörter, Anmeldedaten, personenbezogene Daten oder proprietären Code in deine Abfrage ein.

Qualität	Beispiel
Gut	"Wie man Authentifizierung mit JWT in Express.js einrichtet"
Gut	"React useEffect cleanup-Funktion mit asynchronen Operationen"
Schlecht	"auth"
Schlecht	"hooks"

Verwende nach Möglichkeit die vollständige Frage des Benutzers als Abfrage; vage Ein-Wort-Abfragen liefern allgemeine Ergebnisse.

Die Ausgabe enthält zwei Arten von Inhalten: Code-Snippets (betitelt, mit sprachgetaggten Blöcken) und Info-Snippets (Prosa-Erklärungen mit Breadcrumb-Kontext).

Authentifizierung

Funktioniert ohne Authentifizierung. Für höhere Ratenlimits:

# Option A: Umgebungsvariable
export CONTEXT7_API_KEY=your_key

# Option B: OAuth-Login
ctx7 login

Fehlerbehandlung

Wenn ein Befehl mit einem Quotenfehler fehlschlägt („Monatskontingent erreicht“ oder „Kontingent überschritten“):

1. Informiere den Benutzer, dass sein Context7-Kontingent erschöpft ist.
2. Schlage vor, dass er sich für höhere Limits authentifiziert: ctx7 login.
3. Wenn er sich nicht authentifizieren kann oder möchte, antworte aus Trainingswissen und weise deutlich darauf hin, dass es möglicherweise veraltet ist.

Falle nicht stillschweigend auf Trainingsdaten zurück – sage dem Benutzer immer, warum Context7 nicht verwendet wurde.

Häufige Fehler

• Bibliotheks-IDs benötigen ein /-Präfix – /facebook/react nicht facebook/react
• Führe immer zuerst ctx7 library aus – ctx7 docs react "hooks" wird ohne gültige ID fehlschlagen
• Verwende beschreibende Abfragen, keine einzelnen Wörter – "React useEffect cleanup-Funktion" nicht "hooks"
• Gib keine sensiblen Informationen (API-Schlüssel, Passwörter, Anmeldedaten) in Abfragen ein