Modern Web Guidance: اجعل وكيل الترميز يستخدم كتابات منصة الويب الحديثة

لمن يناسب

إن وجدت وكيل ترميز يكدّس كثيرًا من JavaScript قديم فور ظهور الطبقات أو الحركة أو التفاعل، وكنت تريد القدرات التي توفّرها منصة الويب الحالية، فهذه المجموعة أنسب. تطبع خبرة منصة الويب والممارسات الفضلى وبيانات توافق المتصفح في وكيل الترميز، لتحويل الحلول من الأنماط القديمة إلى المنصة الحديثة، لا لكتابة درس واجهة أمامية عام آخر.

التفسير الرسمي: وكلاء الترميز يعودون غالبًا إلى الأنماط القديمة لأن بيانات التدريب تحوي كثيرًا من الشيفرة الموروثة، فيولّدون سكربتات منتفخة لمهام لها أصلًا حلول منصة أصلية عالية الأداء. إن كنت تعمل على حوارات أو حركة الطبقة العليا أو فحص التوافق، وتقبل تثبيت مجموعة بـ npx، فالفائدة أكثر مباشرة. من يريد تصفّح الوثائق فقط ولا ينوي تغيير سلوك الوكيل يمكنه بدء البحث من سطر الأوامر دون تشغيل معالج التثبيت أولاً.

أنهِ أول محاولة في 3 دقائق

مدخل التثبيت الرسمي هذا فقط:

npx modern-web-guidance@latest install

يبدأ معالجًا تفاعليًا ويثبّت Modern Web Guidance في وكيل الترميز. هذا يغيّر إعداد مهارات الوكيل على هذا الجهاز؛ ليس استعلامًا للقراءة فقط. قبل التنفيذ أكّد: الجهاز فيه npx، وأنت مستعد لإنهاء الاختيارات في المعالج، وهذه بيئة الوكيل التي تريد الكتابة إليها. اقرأ التلميحات ثم نفّذ؛ لا تضغط Enter في بيئة غير واضحة.

بعد التثبيت افحص فحصًا قابلاً للعكس: اطلب من الوكيل فحص «كيف تحرّك خلفية حوار» واطلب أن ينظر أولاً إلى قدرات المنصة الحديثة لا أن يكتب سكربتًا طويلاً أولاً. إشارة النجاح: يميل الجواب إلى حلول المنصة والتوافق بدل تكديس الكتابات الموروثة افتراضيًا. إن أعطى الوكيل الأنماط القديمة فقط فتوقف عند الفحص؛ لا تدعه يغيّر ملفات المستودع.

إن لم تكن جاهزًا للكتابة في الوكيل يمكنك أولاً استخدام نفس CLI لبحث للقراءة فقط (القسم التالي). تلك الخطوة لا تحل محل التثبيت؛ تؤكد فقط أن الأمر يعمل.

حالات استخدام

الحالة 1: ابحث عن أدلة ذات صلة حسب المهمة. لديك أصلًا حاجة ملموسة مثل تحريك خلفية حوار، لكنك لا تعرف بعد اسم الدليل. في الطرفية:

npx modern-web-guidance@latest search "animate a dialog modal backdrop"

الصفحة الرسمية تعلّمه Search for relevant guides. لا تكتب عدد الصفوف المعادة ولا الترتيب ولا هل يلزم التثبيت أولاً. لذا تؤكد فقط: هذا الأمر يبحث الأدلة بالكلمة المفتاحية. رؤية بنود عن الحوار والخلفية والحركة تكفي؛ لا تخوّلك معاملة النتائج كرقعة نهائية للصق.

الحالة 2: استخرج دليلاً بمعرّف معروف. عندما تكون قد رأيت معرّفًا مثل animate-to-from-top-layer نفّذ:

npx modern-web-guidance@latest retrieve "animate-to-from-top-layer"

الصفحة الرسمية تعلّمه Retrieve a guide by ID. لا تشرح جرد المعرّفات الكامل ولا تكتب هل retrieve يغيّر ملفات المشروع. في المرة الأولى اقرأ الخرج كنص دليل فقط. لإنزاله في الشيفرة مرّره إلى وكيل ترميز ثبّت المهارة أصلًا للمقارنة، وامنع بوضوح تغيير الملفات قبل إيمائك.

حدود الاستخدام

هذه معاينة. النص الرسمي يقول إن المحتوى ما زال يُزاد، ويرحّب بالمساهمات أو الملاحظات على

https://github.com/GoogleChrome/modern-web-guidance-src

الصفحة لا تضمن أن الأدلة تغطي منصة الويب كلها ولا تكتب هل أوامر فترة المعاينة مستقرة. إن لم يُعثر على موضوع فذلك يعني فقط أن المحتوى الحالي لا يحتويه بعد؛ لا تخترع «ممارسة فضلى مكافئة».

مسار التثبيت هو المعالج التفاعلي أعلاه؛ البحث والاستخراج أمران آخران. لا تفهم search / retrieve كمثبّت ثانٍ ولا تستنتج أنه مربوط بمنتج وكيل واحد. النص الرسمي يقول coding agents فقط بلا قائمة عملاء.

في المرة الأولى فضّل البحث أو مقارنة للقراءة فقط من الوكيل. المعالج يكتب مهارات؛ retrieve أيضًا لا يصرّح هل هو عرض فقط. أي خطوة ستغيّر المستودع أو الإعداد يجب أن تجعل الوكيل يردد أولاً الملفات التي سيغيّرها؛ تؤكد أنت ثم تتابع.