Fehlerbehebung bei Modern Web Guidance

Modern Web Guidance soll Ihre Entwicklung in Richtung eines „standardmäßig korrekten“ Ansatzes lenken. Gelegentlich können jedoch Probleme mit der Aktivierung von Agenten, der Genauigkeit der Implementierung oder der Erkennung von Funktionen auftreten. In diesem Abschnitt finden Sie Diagnoseschritte, mit denen Sie häufige Probleme beheben können. Sie können beispielsweise prüfen, ob der Modern Web-Skill ordnungsgemäß durch Ihre Prompts ausgelöst wird oder ob Code-Fallbacks mit dem festgelegten Baseline-Status Ihres Projekts übereinstimmen. Wenn Sie auf anhaltende technische Probleme stoßen oder veraltete Anleitungen finden, können Sie ein Problem melden, damit wir diese Ressourcen korrekt und effektiv halten können.

Diagnose, warum Modern Web Guidance nicht von Ihrem KI-Agenten verwendet wird

Wenn Modern Web Guidance installiert ist, werden die Agenten angewiesen, es für alle Webentwicklungsaufgaben zu verwenden. Manchmal ignorieren Kundenservicemitarbeiter diese Anweisungen jedoch.

Sie können den Agenten explizit anweisen, Modern Web Guidance zu verwenden, indem Sie am Ende Ihres Prompts eine Formulierung wie „Verwende Modern Web Guidance“ hinzufügen.

Einige KI-Agenten unterstützen auch den direkten Aufruf eines Skills mit einer bestimmten Syntax, z. B. /modern-web-guidance oder $modern-web-guidance, je nach KI-Agent.

Sehen Sie in der Dokumentation Ihres KI-Agenten nach oder fragen Sie ihn, wie Sie den modern-web-guidance-Skill direkt aufrufen können, wenn Sie sich nicht sicher sind.

„Halluzinierten“ Code oder geratene Implementierungen diagnostizieren

Das ist ein häufiges Problem, bei dem das LLM Wissenslücken ohne Warnung füllt. Damit der Agent keine Informationen erfindet, ist es sehr hilfreich, die folgende Anweisung an Ihre Prompts anzuhängen:

Bring up knowledge gaps and don't attempt to guess implementation. List them as open questions.

Fehler beim Auslösen spezifischer Hinweise diagnostizieren

Wenn Sie einen bestimmten Anwendungsfall für eine Funktion anvisieren und dieser vom Agent nicht erkannt wird, achten Sie darauf, dass Ihre Prompts bestimmte Keywords und Ankeranforderungen enthalten, damit sie richtig erkannt werden. So kann der Agent den relevanten Leitfaden identifizieren (z. B. „Übergänge ansehen“, „LCP-Optimierung“).

Den Denkprozess des KI-Agenten verfolgen:

  • Prüfen Sie in der Ausgabe, ob der Skill modern-web-guidance aufgerufen wurde.
  • Suchen Sie den Suchaufruf, z. B. npx -y modern-web-guidance@latest search "carousel scroll snap", und prüfen Sie, ob die Keywords und die resultierenden Anleitungen Ihren Erwartungen entsprechen.
  • Prüfen Sie, ob der Abrufaufruf den relevanten Leitfaden angefordert hat, z. B. npx -y modern-web-guidance@latest retrieve "carousel-snap-highlights,carousel-slide-effects,scroll-snap-state-sync".
Create a new folder and create a carousel web app for me that implements scroll-snap.

...

● Bash(npx -y modern-web-guidance@latest search "carousel scroll snap" --skill-version 2026_05_16-c5e7870)
  ⎿  [{"id":"carousel-snap-highlights","description":"Visually highlight the currently snapped non-interactive item in scroll-snapping carousels, galleries, or full-page swipe experiences. For example, expanding a card when snapped, or revealing hidden
      content.","category":"user-experience","featuresUsed":["Container scroll-state queries"],"tokenCount":1442,"similarity":0.7783},
      {"id":"carousel-slide-effects","description":"Create a carousel of slides with images or other visual elements, where each slide animates as they enter/center/exit their scroller. For example, the slides may fade-in/fade-out, rotate, get bigger or smaller,
      etc.","category":"user-experience","featuresUsed":["Scroll-driven animations","Scroll snap"],"tokenCount":2105,"similarity":0.6625},
      {"id":"scroll-snap-state-sync","description":"Synchronize navigation indicators, linked content panels, and analytics tracking with the actively snapped item in a scrollable container.","category":"user-experience","featuresUsed":["Scroll snap events","Scroll
      snap"],"tokenCount":1053,"similarity":0.6166},
      {"id":"scroll-snap-realtime-feedback","description":"Provide real-time visual feedback in linked UI elements while a user scrolls through snap-aligned content, before the scroll gesture completes.","category":"user-experience","featuresUsed":["Scroll snap events","Scroll
      snap"],"tokenCount":1886,"similarity":0.5664},
      {"id":"navigation-drawer","description":"Create a navigation drawer component that, when triggered from a menu button, slides in from the side overlayed on top of existing page content, and slides out when dismissed (by swiping away, tapping outside, or pressing
      escape).","category":"user-experience","featuresUsed":["inert","Intersection observer","Popover","Registered custom properties","Scroll-driven animations","scroll-initial-target","Scroll snap"],"tokenCount":4317,"similarity":0.5099}]

● Bash(npx -y modern-web-guidance@latest retrieve "carousel-snap-highlights,carousel-slide-effects,scroll-snap-state-sync")
  ⎿  <output +158 lines>
            }, undefined);
            if (topEntry) setSelectedParagraph(topEntry.id);
          },
          { root: main, threshold: 0.9 // Adjust based on your use case },
        );
        // Observe all snap targets (e.g., section headers)
        document.querySelectorAll('h2').forEach(header => observer.observe(header));
      }
  • Sie können die Suchbefehle auch selbst im Terminal ausführen, um zu sehen, welche Anleitungen Ihrer Suchanfrage entsprechen.
# Search for relevant guides
npx modern-web-guidance@latest search "carousel scroll snap"

Feedback

Wenn Sie weitere Fragen oder Feedback zu diesen neuen Funktionen haben, lesen Sie zuerst, wie Sie zu Modern Web Guidance beitragen können, bevor Sie ein Problem in unserem GitHub-Repository melden. Geben Sie beim Erstellen des Problems die ursprünglichen Prompts des KI-Agenten, Screenshots und Logs des Denkprozesses des KI-Agenten sowie die endgültige Codeänderung an, die auf Grundlage dieses Denkprozesses empfohlen wurde.