Хотя Modern Web Guidance стремится к тому, чтобы разработка велась по принципу "правильно по умолчанию", вы можете столкнуться с проблемами при активации агента, точности реализации или обнаружении функций. В этом разделе приведены инструкции по диагностике, которые помогут вам решить распространенные проблемы, например обеспечить правильный запуск навыка Modern Web с помощью подсказок или проверить, соответствуют ли резервные коды установленному статусу Baseline вашего проекта. Если вы столкнулись с техническими проблемами или заметили устаревшие рекомендации, сообщите нам об этом. Так вы поможете нам поддерживать точность и эффективность этих ресурсов.
Проверьте, почему агент не использует Modern Web Guidance
Когда Modern Web Guidance установлен, агенты используют его для всех задач веб-разработки. Однако агенты иногда игнорируют эти инструкции.
Вы можете явно указать агенту использовать Modern Web Guidance, добавив в конец запроса фразу "используй modern-web-guidance".
Некоторые агенты также поддерживают прямой вызов навыка с помощью определенного синтаксиса, например /modern-web-guidance или $modern-web-guidance, в зависимости от агента.
Если вы не знаете, как это сделать, ознакомьтесь с документацией агента или спросите у него, как вызвать навык "modern-web-guidance".
Диагностика "галлюцинаций" в коде или предположительных реализаций
Это распространенное явление, когда LLM заполняет пробелы в знаниях без предупреждения. Чтобы агент не выдумывал информацию, мы рекомендуем добавлять к запросам следующую инструкцию:
Bring up knowledge gaps and don't attempt to guess implementation. List them as open questions.
Диагностика проблем с активацией определенных рекомендаций
Если вы хотите, чтобы агент выполнял определенные действия, но он этого не делает, убедитесь, что в подсказках есть ключевые слова и требования к привязке. Это помогает агенту определить подходящий путь руководства (например, "переходы между представлениями", "оптимизация LCP").
Отслеживайте ход мыслей агента:
- Проверьте, был ли вызван навык "
modern-web-guidance". - Найдите вызов поиска, например
npx -y modern-web-guidance@latest search "carousel scroll snap", и проверьте, соответствуют ли ключевые слова и полученные руководства вашим ожиданиям. - Убедитесь, что вызов retrieve запрашивает нужное руководство, например
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));
}
- Вы также можете самостоятельно выполнить команды поиска в терминале, чтобы узнать, какие руководства соответствуют вашему поисковому запросу.
# Search for relevant guides
npx modern-web-guidance@latest search "carousel scroll snap"
Как оставить отзыв
Если у вас есть вопросы или отзывы о новых функциях, сначала прочитайте о том, как внести свой вклад в Modern Web Guidance, а затем сообщите о проблеме в нашем хранилище GitHub. При создании проблемы укажите исходные запросы агента, скриншоты и журналы его мыслительного процесса, а также окончательное изменение кода, рекомендованное на основе этого процесса.