למרות שהמטרה של Modern Web Guidance היא להעביר את הפיתוח לגישה של "נכון כברירת מחדל", יכול להיות שמדי פעם תיתקלו בבעיות בהפעלת הסוכן, בדיוק ההטמעה או בגילוי התכונות. בקטע הזה מפורטים שלבי אבחון שיעזרו לכם לפתור בעיות נפוצות, כמו לוודא שההנחיות שלכם מפעילות את המיומנות "פיתוח אתרים מודרני" בצורה נכונה, או לוודא שהקוד החלופי תואם לסטטוס Baseline שנקבע לפרויקט. אם נתקלתם בבעיות טכניות חוזרות או בהנחיות מיושנות, אתם יכולים לדווח על הבעיה כדי לעזור לנו לשמור על המשאבים האלה מדויקים ויעילים.
אבחון הסיבה לכך שהסוכן לא משתמש ב-Modern Web Guidance
כשמתקינים את Modern Web Guidance, הסוכנים מקבלים הוראה להשתמש בו לכל משימות פיתוח האתרים. עם זאת, לפעמים הנציגים מתעלמים מההוראות האלה.
כדי להורות לנציג להשתמש ב-Modern Web Guidance, אפשר להוסיף ביטוי כמו "use 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", ובודקים אם מילות המפתח והמדריכים שהתקבלו הם אלה שציפיתם להם. - מוודאים שהקריאה לאחזור ביקשה את המדריך הרלוונטי, לדוגמה:
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. כשיוצרים את הבעיה, צריך לספק את ההנחיות הראשוניות לסוכן, צילומי מסך ויומנים של תהליך החשיבה של הסוכן, ואת השינוי הסופי בקוד שמומלץ על סמך החשיבה הזו.