Meskipun Modern Web Guidance bertujuan untuk mengarahkan pengembangan Anda ke pendekatan "benar secara default", terkadang Anda mungkin mengalami masalah terkait aktivasi agen, akurasi implementasi, atau penemuan fitur. Bagian ini memberikan langkah-langkah diagnostik untuk membantu Anda menyelesaikan tantangan umum, seperti memastikan Modern Web skill dipicu dengan benar oleh perintah Anda atau memverifikasi bahwa penggantian kode sesuai dengan status Baseline yang ditetapkan project Anda. Jika Anda mengalami hambatan teknis yang terus-menerus atau menemukan panduan yang sudah usang, sebaiknya laporkan masalah tersebut untuk membantu kami menjaga referensi ini tetap akurat dan efektif.
Mendiagnosis Modern Web Guidance yang tidak digunakan oleh agen Anda
Saat Modern Web Guidance diinstal, agen akan diinstruksikan untuk menggunakannya untuk tugas pengembangan web apa pun. Namun, agen terkadang mengabaikan petunjuk ini.
Anda dapat secara eksplisit menginstruksikan agen untuk menggunakan Modern Web Guidance dengan menambahkan frasa seperti "use modern-web-guidance" di akhir perintah Anda.
Beberapa agen juga mendukung pemanggilan langsung keterampilan menggunakan sintaksis tertentu, seperti /modern-web-guidance atau $modern-web-guidance, bergantung pada agennya.
Lihat dokumentasi agen Anda, atau tanyakan kepada agen Anda cara memanggil langsung kemampuan modern-web-guidance jika tidak yakin.
Mendiagnosis kode "halusinasi" atau implementasi yang ditebak
Hal ini biasa terjadi saat LLM mengisi kesenjangan pengetahuan tanpa peringatan. Untuk mencegah agen mengarang informasi, kami menemukan bahwa menambahkan petunjuk berikut ke perintah Anda sangat membantu:
Bring up knowledge gaps and don't attempt to guess implementation. List them as open questions.
Mendiagnosis kegagalan untuk memicu panduan spesifik
Jika Anda menargetkan kasus penggunaan fitur tertentu dan tidak melihatnya ditemukan oleh agen, pastikan perintah Anda menyertakan kata kunci tertentu dan persyaratan anchor untuk visibilitas yang tepat. Hal ini membantu agen mengidentifikasi jalur panduan yang relevan (misalnya: "transisi tampilan", "pengoptimalan LCP").
Lacak proses pemikiran agen:
- Periksa output untuk melihat apakah output tersebut memanggil kemampuan
modern-web-guidance. - Temukan panggilan penelusuran—misalnya,
npx -y modern-web-guidance@latest search "carousel scroll snap"—dan identifikasi apakah kata kunci dan panduan yang dihasilkan adalah yang Anda harapkan. - Pastikan panggilan pengambilan meminta panduan yang relevan, misalnya:
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));
}
- Anda juga dapat menjalankan sendiri perintah penelusuran di terminal untuk melihat panduan yang cocok dengan kueri penelusuran Anda.
# Search for relevant guides
npx modern-web-guidance@latest search "carousel scroll snap"
Masukan
Jika Anda memiliki pertanyaan atau masukan tambahan tentang fitur baru ini, baca cara berkontribusi ke Modern Web Guidance terlebih dahulu sebelum melaporkan masalah di repositori GitHub kami. Saat membuat laporan masalah, berikan perintah awal agen, screenshot dan log proses pemikiran agen, serta perubahan kode akhir yang direkomendasikan berdasarkan pemikiran tersebut.