Was macht Dokumentationssuche über Skripte?
Überblick
Skriptgesteuerte Dokumentationssuche unter Verwendung des llms.txt-Standards.
Führe Skripte aus, um den gesamten Workflow zu bewältigen – kein manueller URL-Aufbau erforderlich.
Primärer Workflow
Skripte IMMER in dieser Reihenfolge ausführen:
# 1. ERKENNE den Abfragetyp (themenspezifisch vs. allgemein)
node scripts/detect-topic.js "<Benutzerabfrage>"
# 2. Rufe die Dokumentation mit der Skriptausgabe ab
node scripts/fetch-docs.js "<Benutzerabfrage>"
# 3. Analysiere die Ergebnisse (bei mehreren zurückgegebenen URLs)
cat llms.txt | node scripts/analyze-llms-txt.js -
Die Skripte übernehmen automatisch den URL-Aufbau, Fallback-Ketten und die Fehlerbehandlung.
Skripte
detect-topic.js – Abfragetyp klassifizieren
- Unterscheidet themenspezifische von allgemeinen Abfragen
- Extrahiert Bibliotheksname + themenspezifisches Schlüsselwort
- Gibt JSON zurück:
{topic, library, isTopicSpecific} - Kein Kontextverbrauch (Zero-Token)
fetch-docs.js – Dokumentation abrufen
- Erstellt automatisch context7.com-URLs
- Handhabt Fallback: Thema → Allgemein → Fehler
- Gibt llms.txt-Inhalt oder Fehlermeldung aus
- Kein Kontextverbrauch (Zero-Token)
analyze-llms-txt.js – llms.txt verarbeiten
- Kategorisiert URLs (kritisch/wichtig/ergänzend)
- Empfiehlt Agentenverteilung (1 Agent, 3 Agenten, 7 Agenten, gestaffelt)
- Gibt JSON mit Strategie zurück
- Kein Kontextverbrauch (Zero-Token)
Workflow-Referenzen
Themenspezifische Suche – Schnellster Pfad (10-15s)
Allgemeine Bibliothekssuche – Umfassende Abdeckung (30-60s)
Repository-Analyse – Fallback-Strategie
Referenzen
context7-patterns.md – URL-Muster, bekannte Repositories
errors.md – Fehlerbehandlung, Fallback-Strategien
advanced.md – Randfälle, Versionierung, Mehrsprachigkeit
Ausführungsprinzipien
- Skripte zuerst – Skripte ausführen anstatt manueller URL-Erstellung
- Kein Kontextverbrauch – Skripte laufen ohne Kontext laden zu müssen
- Automatischer Fallback – Skripte behandeln Thema → Allgemein → Fehler-Ketten
- Progressive Offenlegung – Workflows/Referenzen nur bei Bedarf laden
- Agentenverteilung – Skripte empfehlen parallele Agentenstrategie
Schnellstart
Themenabfrage: „Wie verwende ich die Datumsauswahl in shadcn?“
node scripts/detect-topic.js "<Abfrage>" # → {topic, library, isTopicSpecific}
node scripts/fetch-docs.js "<Abfrage>" # → 2-3 URLs
# URLs mit WebFetch lesen
Allgemeine Abfrage: „Dokumentation für Next.js“
node scripts/detect-topic.js "<Abfrage>" # → {isTopicSpecific: false}
node scripts/fetch-docs.js "<Abfrage>" # → 8+ URLs
cat llms.txt | node scripts/analyze-llms-txt.js - # → {totalUrls, distribution}
# Agenten gemäß Empfehlung einsetzen
Umgebung
Skripte laden .env: process.env > .opencode/skills/docs-seeker/.env > .opencode/skills/.env > .opencode/.env
Siehe .env.example für Konfigurationsoptionen.