Устранение неполадок с Modern Web Guidance

Хотя 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. При создании проблемы укажите исходные запросы агента, скриншоты и журналы его мыслительного процесса, а также окончательное изменение кода, рекомендованное на основе этого процесса.