إنشاء إضافات باستخدام وكلاء الترميز

يمكن الآن لوكلاء الترميز المستند إلى الذكاء الاصطناعي، مثل Antigravity، إنشاء رمز إضافة بدقة رائعة. ومع ذلك، للاستفادة من إمكاناتها بالكامل وضمان الحصول على نتائج عالية الجودة، عليك تزويدها بالسياق والأدوات المناسبة.

يوضّح هذا الدليل كيفية إعداد الأدوات المناسبة في وكلاء الترميز وكيف يمكن أن تساعدك في إنشاء إضافات أفضل بشكل أسرع.

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

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

الإعداد

Modern Web Guidance

لاستخدام حزمة المهارات، ثبِّت Modern Web Guidance في بيئتك المفضّلة وأضِف إليها مهارة الإضافات. في ما يلي تعليمات بعض الأدوات الشائعة.

CLI

يُنصح بتثبيت معظم وكلاء الترميز (بما في ذلك Gemini CLI وClaude Code وCodex) من خلال modern-web-guidance CLI الذي أنشأه فريق Chrome. سيؤدي تثبيت المهارات من خلال واجهة سطر الأوامر modern-web-guidance إلى إبقائها محدّثة تلقائيًا.

  npx modern-web-guidance@latest install --choose

يتم تشغيل معالج تفاعلي لتثبيت المهارات حسب إعداداتك المفضّلة. عند ظهور الخيارات، اختَر وكلاء الترميز واختَر كلاً من chrome-extensions وmodern-web-guidance.

Antigravity

عند تثبيت Antigravity، يمكنك اختيار المكوّن الإضافي Modern Web Guidance الذي يتضمّن مهارة الإضافات، أو يمكنك إضافته من خلال التخصيصات > إنشاء باستخدام مكوّنات Google الإضافية > Modern Web Guidance.

"أدوات مطوّري البرامج في Chrome" لوكلاء الترميز

يمكنك إضافة "أدوات مطوّري البرامج في Chrome" إلى وكيل الترميز الذي تختاره كبرنامج مساعد أو إضافة أو كخادم MCP.

في ما يلي تعليمات بعض البرامج الأكثر شيوعًا.

Antigravity

لاستخدام خادم "بروتوكول سياق النموذج" (MCP) في "أدوات مطوّري البرامج في Chrome"، اتّبِع التعليمات الواردة في مستندات Antigravity لتثبيت خادم MCP مخصّص. أضِف ما يلي إلى إعدادات خوادم MCP:

  {
    "mcpServers": {
      "chrome-devtools": {
        "command": "npx",
        "args": [
          "chrome-devtools-mcp@latest",
          "--category-extensions",
          "-y"
        ]
      }
    }
  }

Claude Code

  claude mcp add chrome-devtools --scope project -- npx chrome-devtools-mcp@latest --categoryExtensions

الوكلاء الآخرون

للحصول على تعليمات حول إعداد وكلاء آخرين، يُرجى الاطّلاع على المستندات في أدوات مطوري البرامج في Chrome MCP GitHub.

CHROMEWEBSTORE.md agent instructions

يُعدّ ملء "لوحة بيانات المطوّرين" جزءًا مهمًا من عملية نشر إضافة. تتصدّى المهارة لهذه المشكلة من خلال جعل وكيل الترميز ينشئ ملف CHROMEWEBSTORE.md ويحتفظ به، ويتتبّع هذا الملف المعلومات الضرورية، بما في ذلك مبرّرات كل إذن مطلوب في الرمز.

سيتم تشغيل الأداة عند استخدام عبارات مثل "لنشر هذا" أو "إعداد هذه الإضافة للمتجر"، ولكن لتبسيط سير عملك المستند إلى الوكلاء، أضِف ما يلي إلى تعليمات النظام الخاصة بالوكيل (على سبيل المثال، ~/.gemini/GEMINI.md لـ Antigravity أو ~/.claude/CLAUDE.md لـ Claude):

Whenever you are creating or making changes to a Chrome extension, create and manage a CHROMEWEBSTORE.md file. You can use the chrome-extensions skill to learn about the format of this file.

إنشاء الإضافة واختبارها باستخدام وكلاء الترميز

تساعد مهارة الإضافة المضمّنة في "إرشادات الويب الحديث" موظفي الدعم بثلاث طرق رئيسية:

• معرفة حديثة بواجهات برمجة التطبيقات: تعلّم الوكلاء أحدث واجهات برمجة التطبيقات التي ربما تم إصدارها بعد تدريب النموذج الذي تستخدمه.
• أفضل الممارسات: تضمن هذه الميزة وصول الموظفين إلى جميع أفضل الممارسات التي تعلّمها فريقنا على مرّ السنين في إنشاء إضافات Chrome.
• جاهزية الإرسال: يتتبّع هذا القسم المعلومات التي قد تحتاج إليها لإرسال إضافتك إلى "سوق Chrome الإلكتروني"، ما يسهّل عملية التوزيع.

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

تساعد المهارة أيضًا برنامجك في تتبُّع المعلومات اللازمة للنشر، بما في ذلك مبرّرات كل إذن مطلوب في الرمز. على سبيل المثال، إذا طلبت من وكيل الترميز إنشاء إضافة باستخدام Side Panel API ونشرها في "سوق Chrome الإلكتروني"، سيتعرّف الوكيل على أنّه يحتاج إلى إذن sidePanel. سيتم بعد ذلك إنشاء ملف CHROMEWEBSTORE.md يتضمّن مبرّرًا. عندما تكون مستعدًا لإرسال الطلب، يمكنك مراجعة هذا التبرير وإجراء أي تعديلات إذا لزم الأمر ونسخه مباشرةً إلى "لوحة بيانات المطوّر".

تتيح "أدوات مطوّري البرامج في Chrome" للوكلاء أن تثبّت مساعدات الترميز المستندة إلى الذكاء الاصطناعي وتصحّح أخطاء الإضافات في نسخة Chrome قيد التشغيل، وتحديدًا:

• تثبيت الإضافات وإلغاء تثبيتها
• إدراج جميع الإضافات المثبَّتة وإعادة تحميلها
• تشغيل إجراءات الإضافة
• فحص كل مساحة عرض في الإضافة (النافذة المنبثقة واللوحة الجانبية ومشغّل الخدمات)

إليك طلبًا وفيديو يوضّح كيفية عمل ذلك عمليًا:

Build a simple "Quick notes" extension that opens a popup text area to save notes and test it in the browser.

في هذه الحالة، يجب أن ينشئ الوكيل ملف Manifest V3 ويطلب الإذن storage لأنّه يعرف أنّه بحاجة إلى الاحتفاظ بالبيانات. يمكن للوكيل الآن إنشاء إضافة وتثبيتها ومشاهدة طريقة عملها والتحقّق من ثباتها بدون مغادرة واجهة المحادثة.

هذا مثال بسيط على الطلب. لمزيد من المعلومات حول تقنيات الطلبات المختلفة والعثور على ما يناسب حالة الاستخدام، يمكنك الاطّلاع على دليلنا حول هندسة الطلبات.

أمثلة على الطلبات لتسهيل التوزيع باستخدام CHROMEWEBSTORE.md

مع أنّ تثبيت مهارة الإضافة وإضافة تعليمات إلى الوكيل سيؤديان معظم العمل، إلا أنّ تحديد التفاصيل في طلباتك يمكن أن يؤدي إلى نتائج أفضل في مرحلة التطوير التي تعمل عليها. في ما يلي دليل سريع حول كيفية توجيه الوكيل لإنشاء ملف CHROMEWEBSTORE.md وتعديله والحفاظ عليه.

• النشر لأول مرة: عندما تكون إضافتك جاهزة تمامًا وتريد إنشاء حضورك الأوّلي على المتجر.

Prepare the extension for publication on the Chrome Web Store.

• تعديل الأذونات وأسباب طلبها: يفرض "سوق Chrome الإلكتروني" سياسة الغرض الوحيد ويتطلّب تقديم أسباب تفصيلية لكل إذن يتم طلبه في manifest.json.

We just added the 'declarativeNetRequest' and 'storage' permissions to our manifest. Let's update our store listing.

• التعامل مع رفض المتجر: إذا تم رفض إضافتك أو الإبلاغ عنها أثناء عملية المراجعة، يمكنك تقديم سبب الرفض مباشرةً إلى الوكيل وطلب تعديل البيانات الوصفية المتعلقة بالامتثال.

Our extension submission was rejected because our privacy policy doesn't explicitly mention how we handle user data locally. Let's update the privacy policy section in CHROMEWEBSTORE.md to resolve this.

الخاتمة

يساعدك الجمع بين مهارات "إرشادات الويب الحديثة" و"أدوات مطوري البرامج في Chrome" للوكلاء في إنشاء ميزات عالية الجودة بشكل أسرع، كما يضمن استقرار الإضافة وجاهزيتها لإرسالها إلى "سوق Chrome الإلكتروني".

ابدأ بتجربة هذه الأدوات في مشروعك التالي لترى كيف يمكنها تبسيط عملية تطوير الإضافة من النموذج الأولي إلى النشر.