تخصيص ردود GitHub Copilot Chat

  • 6 دقائق

يمكن ل GitHub Copilot Chat توليد ردود وبرمجيات تتناسب مع ممارسات البرمجة ومتطلبات مشروعك عند توفير السياق المناسب. بدلا من إضافة هذه المعلومات بشكل متكرر في كل مطالبة دردشة، يمكنك تخزين هذا السياق في الملفات وتضمينه تلقائيا في كل طلب دردشة.

هناك ثلاث طرق رئيسية لتخصيص استجابات الذكاء الاصطناعي في تعليمة Visual Studio برمجية:

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

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

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

التعليمَات المُخصَّصة

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

Note

لا تؤخذ التعليمات المخصصة في الاعتبار لإكمال التعليمات البرمجية.

أنواع التعليمات المخصصة

يدعم تعليمة Visual Studio برمجية ثلاث طرق لتعريف التعليمات المخصصة:

Type Description حالات الاستخدام
.github/copilot-instructions.md ملف Markdown واحد في مساحة العمل ، يتم تضمينه تلقائيا في جميع الطلبات ، ودعم عبر المحررين. ممارسات الترميز العامة والتقنيات المفضلة والمتطلبات على مستوى المشروع.
.instructions.md files ملفات Markdown متعددة مع دعم نمط الكرة الأرضية أو مساحة العمل أو تخزين ملف تعريف المستخدم. تعليمات خاصة بالمهمة ، تحكم دقيق في وقت تطبيق التعليمات.
إعدادات تعليمة Visual Studio برمجية إرشادات في إعدادات المستخدم/مساحة العمل لسيناريوهات محددة. إنشاء التعليمات البرمجية ، وإنشاء الاختبار ، ورسائل الالتزام ، ومراجعات التعليمات البرمجية ، وأوصاف العلاقات العامة.

يمكنك دمج هذه الأساليب، ولكن تجنب الإرشادات المتعارضة حيث لا يتم تطبيق ترتيب الأولوية.

أمثلة على التعليمات المخصصة

إرشادات الترميز العامة:

---
applyTo: "**"
---
# Project coding standards

## Naming Conventions
- Use PascalCase for component names, interfaces, and type aliases.
- Use camelCase for variables, functions, and methods.
- Prefix private class members with underscore (_).
- Use ALL_CAPS for constants.

## Error Handling
- Use try/catch blocks for async operations.
- Implement proper error boundaries in React components.
- Always log errors with contextual information.

إرشادات TypeScript و React:

---
applyTo: "**/*.ts,**/*.tsx"
---
# TypeScript and React standards

Apply the [general coding guidelines](./general-coding.instructions.md) to all code.

## TypeScript Guidelines
- Use TypeScript for all new code.
- Follow functional programming principles where possible.
- Use interfaces for data structures and type definitions.
- Prefer immutable data (const, readonly).
- Use optional chaining (?.) and nullish coalescing (??) operators.

## React Guidelines
- Use functional components with hooks.
- Follow the React hooks rules (no conditional hooks).
- Use React.FC type for components with children.
- Keep components small and focused.
- Use CSS modules for component styling.

استخدم ملف .github/copilot-instructions.md

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

خطوات الإعداد:

  1. تحقق من تفعيل github.copilot.chat.codeGeneration.useInstructionFiles (مفعل افتراضيا في الإصدارات الحديثة من تعليمة Visual Studio برمجية).
  2. قم بالإنشاء .github/copilot-instructions.md في جذر مساحة العمل.
  3. وصف التعليمات باستخدام اللغة الطبيعية وتنسيق Markdown.

Note

يعمل هذا الملف عبر تعليمة Visual Studio برمجية و Visual Studio و GitHub.com.

استخدام ملفات .instructions.md

قم بإنشاء ملفات متعددة .instructions.md لمهام أو لغات برمجة أو أطر عمل أو أنواع مشاريع محددة. يمكن تطبيقها تلقائيا بناء على أنماط الملفات أو إرفاقها يدويا بمطالبات الدردشة.

مواقع الملفات:

  • ملفات مساحة العمل: مخزنة في .github/instructions مجلد، متوفرة فقط داخل مساحة العمل.
  • User files: مخزنة في ملف تعليمة Visual Studio برمجية، متاحة عبر عدة مساحات عمل ومزامنة عبر مزامنة الإعدادات.

هيكل الملف:

---
description: "Brief description of the instructions file"
applyTo: "**/*.ts,**/*.tsx"  # Glob pattern for automatic application
---
# Instructions content in Markdown format

إنشاء ملفات التعليمات واستخدامها:

  1. قم بتشغيله Chat: New Instructions File من لوحة الأوامر.
  2. اختر مساحة العمل أو موقع المستخدم.
  3. أدخل تعليمات الاسم والمؤلف في Markdown.
  4. يستخدم Chat: Configure Instructions لتحرير الملفات الموجودة.

المرفق اليدوي:

  • في عرض Chat: إضافة تعليمات السياق >
  • لوحة الأوامر: Chat: Attach Instructions

التطبيق التلقائي: استخدام applyTo البيانات الوصفية مع أنماط الكرة الأرضية (** لجميع الطلبات ، أنماط محددة للتطبيق المستهدف)

تحديد التعليمات المخصصة في الإعدادات

تكوين تعليمات مخصصة في إعدادات تعليمة Visual Studio برمجية لسيناريوهات محددة:

Scenario Setting
إنشاء التعليمات البرمجية github.copilot.chat.codeGeneration.instructions
توليد الاختبار github.copilot.chat.testGeneration.instructions
مراجعة الكود github.copilot.chat.reviewSelection.instructions
إرسال الرسائل github.copilot.chat.commitMessageGeneration.instructions
عناوين / أوصاف العلاقات العامة github.copilot.chat.pullRequestDescriptionGeneration.instructions

حدد التعليمات كنص أو مرجع ملفات خارجية:

"github.copilot.chat.codeGeneration.instructions": [
  {
    "text": "Always add a comment: 'Generated by Copilot'."
  },
  {
    "text": "In TypeScript always use underscore for private field names."
  },
  {
    "file": "general.instructions.md"
  },
  {
    "file": "db.instructions.md"
  }
]

أفضل الممارسات للتعليمات المخصصة

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

ملفات المطالبة

ملفات المطالبات قابلة لإعادة الاستخدام، ويتم تخزين مهام المهام المستقلة كملفات .prompt.md . على عكس التعليمات المخصصة — التي تصف كيف GitHub Copilot يجب أن تستجيب — تصف ملفات التعليمات ماذا يجب تنفيذها لمهمة محددة. تقوم بتشغيلها عند الطلب بدلا من تطبيقها تلقائيا على كل طلب.

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

إنشاء ملف مطالبة

تخزين ملفات الموجه في .github/prompts/ المجلد في مساحة العمل الخاصة بك. يصبح اسم الملف هو اسم الطلب.

هيكل الملف:

---
mode: "ask"
description: "Generate a product requirements document for a new feature"
---
# Generate a PRD

Create a product requirements document for the described feature.

Include the following sections:
- Product summary
- Target audience
- Core features (prioritized by must-have / should-have / could-have)
- Out of scope
- Technical requirements

Feature description: ${input:Feature description}

تشغيل ملف المطالبة

  • لوحة الأوامر: شغل Chat: Run Prompt واختر الملف.
  • إدخال الدردشة: اكتب # في عرض الدردشة واختر ملف التوجيه بالاسم.

تدعم mode ملفات الأوامر قيم ، askedit، و agent. يمكنهم أيضا الإشارة إلى ملفات التعليمات المخصصة باستخدام بناء جملة رابط Markdown لتجنب تكرار المحتوى عبر الملفات.

أوضاع الدردشة المخصصة

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

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

أنشئ وضع دردشة مخصص

قم بتخزين ملفات وضع الدردشة المخصصة في .github/chatmodes/ المجلد في مساحة العمل الخاصة بك.

هيكل الملف:

---
description: "Plan mode: read-only analysis and architecture decisions"
tools: []
---
You are a software architect in planning mode. Analyze the codebase, identify patterns, suggest designs, and answer questions — but do not make any code changes.

إعدادات وضع الدردشة الشائعة لبرمجة vibe:

وضع Tools حالة الاستخدام
التخطيط لا يوجد (للقراءة فقط) قرارات البنية، تصميم الميزات، مراجعة PRD
أبحاث بحث في الويب دراسة المكتبات، مقارنة الأساليب
تنفيذ الوصول الكامل للأدوات كتابة وتحرير الكود، تشغيل الأوامر
المراجعة للقراءة فقط مراجعة الكود، تدقيق الأمان، فحص الأداء

استخدم وضع الدردشة المخصص

اختر الوضع من أداة اختيار أوضاع الدردشة في شريط أدوات عرض الدردشة. يستمر الوضع طوال الجلسة حتى تقوم بالتغيير.

Summary

تخصيص ردود GitHub Copilot يتيح لك تشكيل مساعدة الذكاء الاصطناعي لتناسب سير عملك الخاص. التعليمات المخصصة — باستخدام ملفات .github/copilot-instructions.md، .instructions.md files، أو إعدادات تعليمة Visual Studio برمجية — تحدد كيف GitHub Copilot يجب أن تستجيب، وترمز ممارساتك البرمجية ومعاييرك وتفضيلاتك. تحدد ملفات الطلبات ما يجب فعله للمهام المتكررة، مما يمنحك طلبات قابلة لإعادة الاستخدام يمكنك تشغيلها عند الطلب. تقوم أوضاع الدردشة المخصصة بضبط كيفية عمل جلسة الدردشة، مما يتيح لك التبديل بين التخطيط، والبحث، والتنفيذ، ومراجعة سير العمل دون تغيير التعليمات الأساسية. معا، تساعدك هذه الأدوات الثلاثة على بناء بيئة برمجة متسقة حيث يفهم GitHub Copilot مشروعك منذ البداية.