درحالیکه هدف Modern Web Guidance سوق دادن توسعه شما بهسمت رویکرد «پیشفرض صحیح» است، ممکن است گاهی با مشکلاتی در فعالسازی عامل، دقت پیادهسازی، یا کشف ویژگی مواجه شوید. این بخش مراحل عیبیابی را برای کمک به شما در حل چالشهای رایج ارائه میدهد، مانند اطمینان از اینکه مهارت «وب مدرن» بهدرستی توسط پیاموارههای شما راهاندازی میشود یا تأیید اینکه کدهای جایگزین با وضعیت «خط مبنای» تعیینشده پروژهتان مطابقت دارند. اگر با موانع فنی مداوم مواجه شدید یا راهنماییهای قدیمی را شناسایی کردید، از شما میخواهیم که مشکلی را ثبت کنید تا به ما کمک کنید این منابع را دقیق و مؤثر نگه داریم.
عیبیابی Modern Web Guidance توسط نماینده شما استفاده نمیشود
وقتی Modern Web Guidance نصب شود، به عاملها دستور داده میشود که از آن برای هرگونه تکلیف توسعه وب استفاده کنند. بااینحال، گاهی اوقات عاملها این دستورالعملها را نادیده میگیرند.
میتوانید با افزودن عبارتی مانند «use modern-web-guidance» به انتهای پیاموارهتان، صریحاً به عامل دستور دهید از 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.
تشخیص عدم راهاندازی راهنمایی خاص
اگر مورد استفاده ویژگی خاصی را هدفیابی میکنید و نمیبینید که توسط نماینده کشف شود، مطمئن شوید که پیاموارههایتان شامل کلیدواژههای خاص و الزامات لنگر برای قابلیت کشف مناسب باشد. این کار به نماینده کمک میکند تا مسیر راهنمایی مربوطه را شناسایی کند (برای مثال: «مشاهده انتقالها»، «بهینهسازی 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 ما ثبت کنید. هنگام ایجاد مشکل، پیاموارههای اولیه عامل، نماگرفتها و گزارشهای فرایند فکری عامل، و تغییر نهایی کد توصیهشده براساس آن تفکر را ارائه دهید.