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.