मॉडर्न वेब गाइडेंस से जुड़ी समस्या हल करना

Modern Web Guidance का मकसद, आपके डेवलपमेंट को "डिफ़ॉल्ट रूप से सही" तरीके की ओर ले जाना है. हालांकि, आपको कभी-कभी एजेंट को चालू करने, उसे लागू करने की प्रोसेस की सटीक जानकारी या सुविधा खोजने में समस्याएं आ सकती हैं. इस सेक्शन में, सामान्य समस्याओं को हल करने के लिए डाइग्नोस्टिक के तरीके बताए गए हैं. जैसे, यह पक्का करना कि आपके प्रॉम्प्ट से Modern Web स्किल सही तरीके से ट्रिगर हो या यह पुष्टि करना कि कोड फ़ॉलबैक, आपके प्रोजेक्ट के Baseline स्टेटस के मुताबिक हों. अगर आपको लगातार तकनीकी समस्याएं आ रही हैं या आपको लगता है कि कोई दिशा-निर्देश पुराना हो गया है, तो कृपया इसकी शिकायत करें. इससे हमें इन संसाधनों को सटीक और असरदार बनाए रखने में मदद मिलेगी.

विश्लेषण करें कि आपके एजेंट ने Modern Web Guidance का इस्तेमाल क्यों नहीं किया

Modern Web Guidance इंस्टॉल होने पर, एजेंट को वेब डेवलपमेंट से जुड़े किसी भी टास्क के लिए इसका इस्तेमाल करने का निर्देश दिया जाता है. हालांकि, कभी-कभी एजेंट इन निर्देशों को अनदेखा कर देते हैं.

एजेंट को साफ़ तौर पर Modern Web Guidance का इस्तेमाल करने के लिए कहा जा सकता है. इसके लिए, अपने प्रॉम्प्ट के आखिर में "use modern-web-guidance" जैसा कोई वाक्यांश जोड़ें.

कुछ एजेंट, सिंटैक्स का इस्तेमाल करके किसी स्किल को सीधे तौर पर शुरू करने की सुविधा भी देते हैं. जैसे, /modern-web-guidance या $modern-web-guidance. यह एजेंट पर निर्भर करता है.

अपने एजेंट का दस्तावेज़ देखें या अगर आपको नहीं पता है, तो अपने एजेंट से पूछें कि modern-web-guidance स्किल को सीधे कैसे चालू किया जाए.

"गलत" कोड या अनुमानित तौर पर लागू किए गए कोड का विश्लेषण करना

यह एक आम बात है, जब एलएलएम बिना किसी चेतावनी के जानकारी की कमियों को पूरा करता है. एजेंट को मनगढ़ंत जानकारी देने से रोकने के लिए, हमने पाया है कि अपने प्रॉम्प्ट में यह निर्देश जोड़ना बहुत मददगार होता है:

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

खास दिशा-निर्देश ट्रिगर न होने की समस्या का विश्लेषण करना

अगर आपको किसी खास सुविधा के इस्तेमाल के उदाहरण को टारगेट करना है और आपको एजेंट से वह सुविधा नहीं मिल रही है, तो पक्का करें कि आपके प्रॉम्प्ट में खास कीवर्ड और ऐंकर से जुड़ी ज़रूरी शर्तें शामिल हों, ताकि उसे आसानी से खोजा जा सके. इससे एजेंट को काम के दिशा-निर्देश ट्रैक करने में मदद मिलती है. उदाहरण के लिए: "व्यू ट्रांज़िशन", "एलसीपी ऑप्टिमाइज़ेशन".

एजेंट की सोच-विचार की प्रोसेस को ट्रैक करना:

  • आउटपुट देखकर पता लगाएं कि क्या 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"

सुझाव/राय दें या शिकायत करें

अगर इन नई सुविधाओं के बारे में आपका कोई और सवाल या सुझाव है, तो हमारी GitHub रिपॉज़िटरी में समस्या दर्ज करने से पहले, Modern Web Guidance में योगदान देने के तरीके के बारे में पढ़ें. समस्या की जानकारी देते समय, एजेंट के शुरुआती प्रॉम्प्ट, एजेंट के सोचने की प्रोसेस के स्क्रीनशॉट और लॉग, और उस सोच के आधार पर सुझाए गए कोड में किए गए बदलाव की जानकारी दें.