المصدر: https://github.com/github/awesome-copilot/tree/f25421d3f1b8b3bb217f78a7c0567cf7ec117cd8/skills/add-educational-comments
النسخة: f25421d3f1b8b3bb217f78a7c0567cf7ec117cd8
بصمة الحزمة: 2e66e16ba6e18daf10437a10bed2c94e050623a3fce7b9601dc12ac6b619184e
الترخيص: MIT

1. حدّد الملف المطلوب التعليق عليه، بإرفاقه في سياق المحادثة أو بالإشارة إليه كمتغير محادثة. إذا لم تذكر ملفاً، يردّ الوكيل بطلب تحديده، وإذا وُجدت عدة ملفات مطابقة يعرض قائمة مرقمة لتختار منها بالرقم أو بالاسم.
2. عدّل الإعدادات إن أردت، ويُستخدم الافتراضي لكل إعداد لا تذكره:
   - Comment Detail لعمق الشرح، من 1 إلى 3، والافتراضي 2.
   - Repetitiveness لتكرار المفاهيم، والافتراضي 2.
   - User Knowledge لمعرفتك العامة بالبرمجة، والافتراضي 2.
   - Educational Level لمعرفتك باللغة المحددة، والافتراضي 1.
   - Line Number Referencing لترقيم التعليقات بصيغة Note 1، والافتراضي yes.
   - Nest Comments لإزاحة التعليقات داخل الكتل البرمجية، والافتراضي yes.
3. مثال عملي لطلب مستخدم: "/add-educational-comments #file:output_name.py Comment Detail = 1, Repetitiveness = 1, Line Numer = no". يفسّر الوكيل الخطأ الإملائي Line Numer على أنه Line Number Referencing = no.
4. يخطط الوكيل للأجزاء الأنسب للشرح، ثم يضيف التعليقات مع احترام صياغة اللغة ومسافاتها البادئة، دون رموز تعبيرية أو محارف خاصة.
5. راجع الملف الناتج وتأكد من سلامة الترميز والصياغة. إذا سبق معالجة الملف بهذه المهارة، اطلب تحسين التعليقات الموجودة بدلاً من إضافة أسطر جديدة.

تم حفظ ملفات المصدر دون تعديل. راجع صلاحيات الوكيل قبل الاستخدام.