Drittanbieter-Integrations-Debugger

Das Problem

Drittanbieter-Integrationen sind Blackboxes, die auf unkontrollierbare Weise brechen. Das Payment-SDK wirft undokumentierte Fehler, die Analytics-Bibliothek kollidiert mit dem Bundler, der OAuth-Provider hat sein Token-Format geaendert. Man kann den Quellcode nicht lesen, die Dokumentation ist veraltet, und der Support antwortet in 48 Stunden. Man ist auf sich allein gestellt.

Der Prompt

Du bist ein Drittanbieter-Integrations-Debugger. Hilf mir zu diagnostizieren, warum diese externe Bibliothek/API/SDK nicht funktioniert:

INTEGRATION: [Bibliotheksname + Version, z.B. Stripe SDK 14.2, Auth0 SPA SDK 2.1]
DEIN STACK: [Framework, Runtime, Bundler]
WAS VORHER FUNKTIONIERTE: [letzter bekannter funktionierender Zustand]
WAS SICH GEAENDERT HAT: [was aktualisiert wurde]
FEHLER/SYMPTOM: [exakter Fehler oder unerwartetes Verhalten]

Diagnostiziere das Integrationsproblem:
1. **Changelog-Scan**: Was aenderte sich zwischen der vorherigen funktionierenden und der aktuellen Version? Alle Breaking Changes und Deprecations auflisten.
2. **Kompatibilitaetsmatrix**: Ist diese SDK-Version mit deiner Runtime, deinem Framework und Bundler kompatibel?
3. **Konfigurations-Diff**: Konfiguration gegen aktuelle Dokumentation vergleichen. Veraltete Config-Keys, umbenannte Optionen kennzeichnen.
4. **Known-Issues-Suche**: Basierend auf dem Fehler das wahrscheinlichste bekannte Issue aus GitHub Issues oder Changelog identifizieren.
5. **Isolationstest**: Eine minimale Reproduktion liefern, die NUR die Drittanbieter-Integration testet.
6. **Workaround + Fix**: Bei bekanntem Library-Bug den Workaround liefern. Bei Konfigurationsproblem die aktualisierte Config.

Beispiel-Ausgabe

Changelog: Stripe SDK v14.0 → v14.2 aenderte Webhook-Signaturverifikation — erfordert jetzt Raw Body
Kompatibilitaet: SDK v14.2 erfordert Node 18+ — Lambda laeuft auf Node 16
Config-Diff: `apiVersion`-Standard aenderte sich — beeinflusst PaymentIntent-Response-Shape
Known Issue: GitHub #2847 — Webhook-Verifikation scheitert mit Express Body-Parser-Middleware
Fix: app.post('/webhook', express.raw({type: 'application/json'}), handler) statt globales express.json()

Wann verwenden

Diesen Skill einsetzen, wenn eine Drittanbieter-Bibliothek oder API nach einem Update nicht mehr funktioniert, wenn Integrationscode ohne eigene Code-Aenderungen bricht, oder wenn die Fehlermeldung auf Library-Interna zeigt statt auf eigenen Code.

Profi-Tipps

• Dependencies pinnen — exakte Versionen verwenden ("stripe": "14.1.0", nicht "^14.1.0") fuer kritische Integrationen.
• Migrationsanleitung VOR dem Update lesen — die meisten Integrationsfehler kommen vom Updaten ohne Changelog-Lektuere.
• GitHub Issues der Bibliothek pruefen — mit der exakten Fehlermeldung suchen. Fix oder Workaround steht meist in den Kommentaren.
• Debug-Modus der Bibliothek nutzen — die meisten SDKs haben Verbose-Logging (DEBUG=stripe:*, SENTRY_DEBUG=true).