Rozwiązywanie problemów z wskazówkami dotyczącymi nowoczesnych stron internetowych

Chociaż Modern Web Guidance ma na celu ukierunkowanie rozwoju na podejście „domyślnie poprawne”, czasami mogą wystąpić problemy z aktywacją agenta, dokładnością implementacji lub wykrywaniem funkcji. W tej sekcji znajdziesz kroki diagnostyczne, które pomogą Ci rozwiązać typowe problemy, takie jak zapewnienie, że umiejętność Modern Web jest prawidłowo aktywowana przez prompty, lub sprawdzenie, czy kody zastępcze są zgodne z ustalonym stanem Baseline projektu. Jeśli napotkasz powtarzające się problemy techniczne lub zauważysz nieaktualne wskazówki, zgłoś problem, aby pomóc nam w utrzymaniu dokładności i skuteczności tych zasobów.

Zdiagnozuj, dlaczego Modern Web Guidance nie jest używany przez agenta

Gdy rozszerzenie Modern Web Guidance jest zainstalowane, agenty otrzymują instrukcje, aby używać go do wszystkich zadań związanych z tworzeniem stron internetowych. Czasami jednak agenci ignorują te instrukcje.

Możesz wyraźnie poinstruować agenta, aby używał Modern Web Guidance, dodając na końcu prompta frazę taką jak „użyj modern-web-guidance”.

Niektórzy agenci obsługują też bezpośrednie wywoływanie umiejętności przy użyciu określonej składni, np. /modern-web-guidance lub $modern-web-guidance, w zależności od agenta.

Jeśli nie masz pewności, zapoznaj się z dokumentacją agenta lub zapytaj go, jak bezpośrednio wywołać umiejętność modern-web-guidance.

Diagnozowanie „halucynacji” kodu lub domniemanych implementacji

To częste zjawisko, gdy LLM uzupełnia luki w wiedzy bez ostrzeżenia. Aby zapobiec wymyślaniu informacji przez agenta, warto dodać do promptów tę instrukcję:

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

Diagnozowanie niepowodzenia aktywacji konkretnych wskazówek

Jeśli kierujesz reklamy na konkretny przypadek użycia funkcji i nie widzisz, aby agent go wykrywał, upewnij się, że prompty zawierają konkretne słowa kluczowe i wymagania dotyczące kotwic, aby zapewnić prawidłowe wykrywanie. Pomaga agentowi zidentyfikować odpowiednią ścieżkę wskazówek (np. „wyświetl przejścia”, „optymalizacja LCP”).

Śledzenie toku myślenia agenta:

  • Sprawdź dane wyjściowe, aby zobaczyć, czy została wywołana umiejętność modern-web-guidance.
  • Znajdź wywołanie wyszukiwania, np. npx -y modern-web-guidance@latest search "carousel scroll snap", i sprawdź, czy słowa kluczowe i wynikowe przewodniki są zgodne z oczekiwanymi.
  • Sprawdź, czy wywołanie pobierania żądało odpowiedniego przewodnika, na przykład: 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));
      }
  • Możesz też samodzielnie uruchomić polecenia wyszukiwania w terminalu, aby zobaczyć, które przewodniki pasują do Twojego zapytania.
# Search for relevant guides
npx modern-web-guidance@latest search "carousel scroll snap"

Prześlij opinię

Jeśli masz dodatkowe pytania lub uwagi dotyczące tych nowych funkcji, najpierw dowiedz się, jak możesz pomóc w rozwoju Modern Web Guidance, zanim zgłosisz problem w naszym repozytorium GitHub. Podczas tworzenia zgłoszenia podaj początkowe prompty agenta, zrzuty ekranu i dzienniki procesu myślowego agenta oraz ostateczną zmianę kodu zalecaną na podstawie tego procesu.