Umgebungs-Diff-Debugger

Das Problem

“Es funktioniert auf meinem Rechner.” Fuenf Worte, die jedes Entwicklungsteam verfolgen. Der Code ist identisch, die Tests laufen lokal durch, aber Produktion verhaelt sich anders. Der Unterschied verbirgt sich in Umgebungsvariablen, Betriebssystemversionen, Node.js-Versionen, installierten Systembibliotheken, Dateiberechtigungen, Zeitzonen-Einstellungen oder einem Dutzend anderer unsichtbarer Faktoren.

Der Prompt

Du bist ein Umgebungs-Forensik-Spezialist. Finde den versteckten Unterschied zwischen zwei Umgebungen:

UMGEBUNG A (funktioniert): [z.B. lokale Entwicklung, macOS, Node 20.11]
UMGEBUNG B (kaputt): [z.B. Produktion, Linux, Node 20.9]

SYMPTOM IN UMGEBUNG B: [was schiefgeht]
IDENTISCHE FAKTOREN: [was bereits als uebereinstimmend bestaetigt wurde]

Fuehre eine Umgebungs-Differentialdiagnose durch:
1. **Runtime-Versions-Diff**: Exakte Runtime-Versionen vergleichen. Auch Patch-Versionen sind relevant.
2. **OS- und System-Diff**: OS, Architektur (arm64 vs x86_64), Systembibliotheken, Dateisystem-Case-Sensitivity vergleichen.
3. **Umgebungsvariablen-Audit**: Jede env-Variable auflisten, die die Anwendung liest. Werte zwischen Umgebungen vergleichen. Auf FEHLENDE Variablen pruefen.
4. **Dependency-Tree-Diff**: package-lock.json, native Modul-Builds und optionale Dependencies vergleichen.
5. **Netzwerk- und DNS-Diff**: DNS-Aufloesung, Proxy-Einstellungen, Firewall-Regeln, SSL-Zertifikatsspeicher vergleichen.
6. **Dateisystem- und Berechtigungs-Diff**: Dateiberechtigungen, Eigentuemer, Case-Sensitivity, Symlink-Handling pruefen.
7. **Der wahrscheinliche Schuldige**: Basierend auf dem Symptom die wahrscheinlichste Differenzkategorie ranken.

Beispiel-Ausgabe

Runtime: Node 20.11.1 (lokal) vs 20.9.0 (Prod) — Breaking Change im URL-Parsing
Env-Variablen: DATABASE_URL lokal vorhanden (aus .env), in Produktion fehlend
Dependency: sharp@0.33 baut native Module unterschiedlich auf macOS arm64 vs Linux x86_64
Wahrscheinlicher Schuldiger: #1 Fehlende DATABASE_URL (90%) — App faellt auf SQLite zurueck, wenn Variable fehlt

Wann verwenden

Diesen Skill einsetzen, wenn Code in einer Umgebung funktioniert, aber in einer anderen versagt. Unverzichtbar bei Deployment-Fehlern, CI/CD-Pipeline-Problemen und Cross-Platform-Bugs.

Profi-Tipps

• env oder printenv verwenden, um ALLE Umgebungsvariablen auszugeben — dann die Ausgaben diff-en. Versteckte Proxy-Variablen und Locale-Variablen verursachen oft subtile Unterschiede.
• Docker garantiert keine identischen Umgebungen — verschiedene Host-OS, Kernel-Versionen und Docker-Engine-Versionen koennen das Verhalten in Containern beeinflussen.
• Zeitzone pruefen — wenn die Abweichung mit dem UTC-Offset korreliert, liegt der Fehler in der Datum/Uhrzeit-Verarbeitung.