على الرغم من أنّ "إرشادات الويب الحديث" تهدف إلى توجيه عملية التطوير نحو اتّباع نهج "صحيح تلقائيًا"، قد تواجه أحيانًا مشاكل في تفعيل الوكيل أو دقة التنفيذ أو اكتشاف الميزات. يقدّم هذا القسم خطوات تشخيصية لمساعدتك في حلّ التحديات الشائعة، مثل التأكّد من أنّ مهارة "الويب الحديث" يتم تفعيلها بشكل صحيح من خلال طلباتك أو التحقّق من أنّ عمليات الرجوع إلى الإصدارات السابقة من الرمز البرمجي تتوافق مع حالة "الحد الأدنى" المحدّدة لمشروعك. إذا واجهت عقبات فنية مستمرة أو رصدت إرشادات قديمة، ننصحك بإبلاغنا عن المشكلة لمساعدتنا في الحفاظ على دقة هذه المراجع وفعاليتها.
تشخيص عدم استخدام وكيلك "إرشادات الويب الحديث"
عند تثبيت إرشادات الويب الحديث، يتم توجيه الوكلاء لاستخدامه في أي مهام متعلقة بتطوير الويب. ومع ذلك، تتجاهل البرامج أحيانًا هذه التعليمات.
يمكنك توجيه الوكيل صراحةً لاستخدام "إرشادات الويب الحديثة" من خلال إضافة عبارة مثل "استخدام إرشادات الويب الحديثة" إلى نهاية طلبك.
تتيح بعض البرامج أيضًا استدعاء مهارة مباشرةً باستخدام صيغة معيّنة، مثل /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"، وحدِّد ما إذا كانت الكلمات الرئيسية والأدلة الناتجة هي ما توقعته. - تأكَّد من أنّ طلب الاسترداد قد طلب الدليل ذي الصلة، على سبيل المثال:
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. أثناء إنشاء المشكلة، قدِّم طلبات الوكيل الأولية ولقطات الشاشة والسجلات الخاصة بعملية التفكير التي اتّبعها الوكيل، والتغيير النهائي في الرمز البرمجي الذي تم اقتراحه استنادًا إلى عملية التفكير هذه.