إضافة تعليقات تعليمية إلى ملفات الشيفرة البرمجية لتصبح موارد تعلّم

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. راجع الملف الناتج وتأكد من سلامة الترميز والصياغة. إذا سبق معالجة الملف بهذه المهارة، اطلب تحسين التعليقات الموجودة بدلاً من إضافة أسطر جديدة.

لا تتطلب المهارة حسابات أو حزماً خارجية. هي إرشادات نصية تحتاج وكيلاً قادراً على قراءة الملفات وتعديلها في مساحة العمل. ملاحظات وقيود: - صيغة الإشارة إلى الملفات مثل #file: وأمر الشرطة المائلة في الأمثلة مستوحاة من بيئات محادثة معينة، وقد تختلف طريقة الإرفاق من وكيل لآخر. - يتضمن الإعداد Fetch List روابط مرجعية اختيارية، منها PEP 263. استخدامها يتطلب قدرة على الوصول إلى الويب، وهي غير ضرورية لعمل المهارة. - قاعدة زيادة 125% محدودة بـ 400 سطر كحد أقصى، وبنحو 300 سطر للملفات التي تتجاوز 1000 سطر. - المهارة تعدّل الملف الأصلي مباشرة، لذا يُنصح بمراجعة التغييرات أو استخدام نظام تحكم بالإصدارات قبل اعتمادها. - لا تضمن المهارة خلو الناتج من الأخطاء، وتبقى المراجعة البشرية ضرورية. - الترخيص: MIT.