GitHub AI & ML

تطبيق GitHub Copilot للمبتدئين: كيف تُعلّم Copilot عن قاعدة الكود الخاصة بك

تعرّف على كيفية إضافة تعليمات ومهارات مخصّصة إلى مستودعك، واستخدام وكلاء مخصّصين، وربط خوادم MCP مثل Playwright. ظهر المقال تطبيق GitHub Copilot للمبتدئين: كيف تُعلّم Copilot عن قاعدة الكود الخاصة بك أولاً على The GitHub…

Copilot moves through a decorative field of floating cubes marked with sync and check icons.
مصدر الصورة · GitHub AI & ML

السياق مهم عند العمل مع الذكاء الاصطناعي. لكل قاعدة كود قواعدها الداخلية الخاصة: كيف تُهيَّكل المكوّنات، وما السكربتات التي يجب تشغيلها، وما الاصطلاحات التي تنطبق على الأطر وأنواع الملفات المختلفة.

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

في هذه الحلقة من سلسلتنا تطبيق GitHub Copilot للمبتدئين، سنستعرض أربع طرق لتخصيص طريقة عمل Copilot مع مشروعك:

  • التعليمات المخصّصة تُبلّغ Copilot بالاصطلاحات التي يجب أن يتبعها.
  • مهارات الوكيل تُغلّف الإجراءات القابلة للتكرار.
  • الوكلاء المخصّصون يقدّمون توجيهاً متخصصاً للمهام الأكبر.
  • خوادم بروتوكول سياق النموذج (MCP) تربط Copilot بأدوات ومصادر بيانات خارجية، ما يوسّع ما يمكنها فعله.

لنلقِ نظرة على كيفية عمل كل منها وكيف يمكن أن تعمل معاً.

ابدأ بالتعليمات المخصّصة

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

التعليمات المخصّصة للمستودع تمنح Copilot ذلك السياق الأساسي. أضف ملف .github/copilot-instructions.md لتعريف إرشادات تنطبق على المستودع بأكمله، مثل البنية المعمارية المفضّلة لديك، أو اصطلاحات التسمية، أو التوقعات المتعلقة بالاختبار والتحقق.

يمكنك أيضاً إنشاء ملفات تعليمات خاصة بمسارات معيّنة داخل .github/instructions. تستخدم هذه الملفات حقلاً باسم applyTo لإخبار Copilot متى تكون تلك الإرشادات ذات صلة.

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

غلّف الإجراءات القابلة للتكرار كمهارات وكيل

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

وهنا تأتي دور مهارات الوكيل . المهارة هي مجلد يحتوي على تعليمات، واختيارياً سكربتات وموارد أخرى يمكن لـ Copilot تحميلها عندما تكون ذات صلة. يمكن أن توجد مهارات على مستوى المشروع في .github/skills، مع كل مهارة في مجلد فرعي خاص بها.

على سبيل المثال، يمكن أن يحتوي مجلد .github/skills/quality-checks على ملف SKILL.md يشرح:

  • متى ينبغي أن تستخدم Copilot المهارة.
  • ما السكربتات التي تشغّل اختبارات المشروع وفحوصات الـ linting.
  • ما يتحقق منه كل سكربت.
  • كيفية استكشاف الأخطاء الشائعة وإصلاحها.

الوصف في SKILL.md يساعد Copilot في تحديد متى تنطبق المهارة. بعد تحديث الواجهة، يمكن لـ Copilot تحميل مهارة quality-checks واتباع العملية المعتمدة في المشروع للاختبار والـ linting بدلاً من تخمين الأوامر التي يجب تشغيلها.

استخدم وكيلاً مخصصاً لأعمال أوسع ومتخصصة

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

الوكلاء المخصصون تتيح لك إنشاء نسخ متخصصة من Copilot لمثل هذه الأعمال. يوجد ملف تعريف الوكيل على مستوى المستودع في .github/agents ويمكنه تحديد غرض الوكيل وتعليماته وأدواته وسياق المشروع ذي الصلة.

استخدم وكيلاً مخصصاً عندما يستفيد نوع متكرر من العمل من دور أو منظور مخصص، خاصة عندما تمتد المهمة عبر ملفات متعددة وتعتمد على عدة أدوات أو مصادر سياق.

اربط Copilot بالأدوات الخارجية عبر خوادم MCP

تساعد التعليمات والمهارات والوكلاء Copilot على فهم كيفية العمل ضمن مشروعك. وتوسّع خوادم MCP ما يمكنه الوصول إليه والقيام به بما يتجاوز المستودع.

خوادم MCP تربط Copilot بالأدوات الخارجية ومصادر البيانات والخدمات. يمكن لخادم توثيق أن يمنحه الوصول إلى إرشادات الإطار، بينما يمكن لخادم مثل Playwright أن يتيح له فتح تطبيقك والتفاعل معه في المتصفح.

يمكنك تصفح خوادم MCP المتاحة في تطبيق Copilot أو إضافة خادم مخصص. بمجرد تكوين Playwright، يمكنك أن تسأل: استخدم خادم Playwright MCP لاختبار الوظائف يدويًا.

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

اختر النوع المناسب من التخصيصات

تحل هذه التخصيصات مشكلات مختلفة، لكنها تصبح أكثر فائدة عند دمجها:

  • التعليمات المخصصة تحدد الاصطلاحات التي يجب على Copilot اتباعها في المستودع بأكمله أو في ملفات معينة.
  • مهارات الوكيل تغلّف الإجراءات القابلة للتكرار والتي يمكن لـ Copilot تحميلها عندما تكون ذات صلة.
  • الوكلاء المخصصون توفر خبرة وتوجيهًا مركزين للمهام الأوسع.
  • خوادم MCP تربط Copilot بالأدوات والخدمات ومصادر البيانات الخارجية، موسعةً ما يمكن لـ Copilot القيام به.

خذ هذا معك

يبدأ منح Copilot سياقًا مفيدًا للمشروع بأربعة أسئلة:

  • ما الاصطلاح في المشروع الذي أضطر لشرحه باستمرار؟
  • ما الإجراء متعدد الخطوات الذي أكرره؟
  • ما المهمة المعقدة التي قد تستفيد من وكيل مخصص مخصص لها؟
  • ما الأداة أو المصدر الخارجي الذي يحتاجه Copilot؟

غير متأكد من أين تبدأ؟ لقد شارك المجتمع تعليمات ومهارات ووكلاء والمزيد جاهزة عبر Awesome Copilot. ابحث عن واحد يعالج سير عمل تكرره بالفعل، وراجع ما يحتويه، وقم بتكييفه مع أدوات ومعايير مستودعك.

ابدأ صغيرًا: اختر اصطلاحًا واحدًا تضطر لشرحه باستمرار، وأضفه إلى .github/copilot-instructions.md، وشاهد كيف يطبقه Copilot على مهمتك التالية.

جرّب استخدام تطبيق GitHub Copilot >

ظهر المقال تطبيق GitHub Copilot للمبتدئين: كيف تعلّم Copilot عن قاعدة الشيفرة الخاصة بك أول مرة على مدونة GitHub.

المصدر الأصلي

GitHub AI & ML

ملاحظات المحتوى

النشر الأصلي والحقوق تعود إلى المصدر.

ترجمة آلية · يُرجى الرجوع إلى الأصل