Dokumentationssuche über Skripte
Überblick
Skript-orientierte Dokumentationssuche unter Verwendung des llms.txt-Standards.
Führe Skripte aus, um den gesamten Workflow zu bewältigen – keine manuelle URL-Konstruktion erforderlich.
Primärer Workflow
FÜHRE Skripte IMMER in dieser Reihenfolge aus:
# 1. ERKENNE Abfragetyp (themenspezifisch vs. allgemein)
node scripts/detect-topic.js "<Benutzerabfrage>"
# 2. Rufe Dokumentation mit Skriptausgabe ab
node scripts/fetch-docs.js "<Benutzerabfrage>"
# 3. ANALYSIERE Ergebnisse (falls mehrere URLs zurückgegeben wurden)
cat llms.txt | node scripts/analyze-llms-txt.js -
Skripte übernehmen URL-Konstruktion, Fallback-Ketten und Fehlerbehandlung automatisch.
Skripte
detect-topic.js – Abfragetyp klassifizieren
- Unterscheidet themenspezifische von allgemeinen Abfragen
- Extrahiert Bibliotheksname + Themen-Schlüsselwort
- Gibt JSON zurück:
{topic, library, isTopicSpecific} - Ausführung mit null Token
fetch-docs.js – Dokumentation abrufen
- Erstellt automatisch context7.com-URLs
- Behandelt Fallback: Thema → allgemein → Fehler
- Gibt llms.txt-Inhalt oder Fehlermeldung aus
- Ausführung mit null Token
analyze-llms-txt.js – llms.txt verarbeiten
- Kategorisiert URLs (kritisch/wichtig/ergänzend)
- Empfiehlt Agentenverteilung (1 Agent, 3 Agenten, 7 Agenten, phasenweise)
- Gibt JSON mit Strategie zurück
- Ausführung mit null Token
Workflow-Referenzen
Themenspezifische Suche – Schnellster Pfad (10–15 s)
Allgemeine Bibliothekssuche – Umfassende Abdeckung (30–60 s)
Repository-Analyse – Fallback-Strategie
Referenzen
context7-patterns.md – URL-Muster, bekannte Repositorys
errors.md – Fehlerbehandlung, Fallback-Strategien
advanced.md – Randfälle, Versionierung, Mehrsprachigkeit
Ausführungsprinzipien
- Skripte zuerst – Skripte ausführen statt manuelle URL-Konstruktion
- Null-Overhead – Skripte laufen ohne Kontextladung
- Automatischer Fallback – Skripte behandeln Ketten: Thema → allgemein → Fehler
- Progressive Offenlegung – Workflows/Referenzen nur bei Bedarf laden
- Agentenverteilung – Skripte empfehlen parallele Agentenstrategie
Schnellstart
Themenabfrage: „Wie verwende ich den Datumsauswähler 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 > .claude/skills/docs-seeker/.env > .claude/skills/.env > .claude/.env
Siehe .env.example für Konfigurationsoptionen.