أوامر برمجة لمن يبدأ ويريد فهم السطر لا ملفًا جاهزًا

أسرع طريق لإغلاق الصفحة وأنت لا تزال لا تبرمج: أن تطلب «ابنِ لي التطبيق» فينزل ملف لا تستطيع تعديل سطر فيه. هذه الأوامر تشترط أن يبقى الكود صغيرًا وأن تكتبه أنت في الخطوة التالية. إن كنت في أول صفحة HTML، فابدأ بالمشروع الواحد المشروح في تعلّم البرمجة بمشروع صفحة واحدة ثم عد إلى الأمر الذي يناسب العطل الذي أمامك.

بيئة تجرب فيها الكود من غير تنصيب ثقيل: Replit. مسار الدروس من الصفر على freeCodeCamp إن أردت تمارين خارج المحادثة. المساعد داخل المحرر، مثل Cursor أو GitHub Copilot، مفيد بعد أن تقرأ الفرق لا قبل أن تعرف ماذا يفعل الملف. اختيار مساعد المحادثة نفسه في المقارنة.

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

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

كيف تكيّف الأقواس

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

الأوامر الجاهزة

1. ١. اشرح الخطأ ولا تصلح المشروع

   حين ظهرت رسالة حمراء وتريد معناها قبل أن يُستبدل الملف.

   الصق [الرسالة] كما هي. في [الكود] الصق الدالة فقط. اكتب [اللغة]. لا تلخص الخطأ بكلماتك إن كانت الرسالة أمامك.

   اشرح رسالة الخطأ هذه لجمهور مبتدئ.
   اللغة: [الاسم، والإصدار إن عرفته أو «لا أعرف»]
   لا تعطني ملفًا بديلًا.
   قل أي سطر أراجع أولًا، ولماذا.
   إن كان السبب خارج اللقطة فقل «النقص» ولا تخمّن ملفًا لم ألصقه.
   الرسالة:
   [النص]
   الكود:
   [الدالة فقط]

2. ٢. علّمني الدالة ثم اطلبها مني

   حين تعرف المهمة، مثل «دالة تجمع أرقام القائمة»، وتريد أن تكتبها لا أن تصلك جاهزة.

   صف [المهمة] بجملة. أعطِ [مثال دخل] و[مثال خرج] صغيرين من تأليفك، بأرقام غير حقيقية.

   أنا مبتدئ في [اللغة].
   المهمة: [جملة].
   مثال دخل: [صغير]
   مثال خرج: [صغير]
   اشرح الفكرة في خمس جمل من غير كود كامل.
   ثم اطلب مني أن أكتب الدالة في الرسالة التالية.
   لا تكتب الحل في هذه الرسالة.
   إن كان مثالي يناقض المهمة فقل ذلك وتوقف.

3. ٣. راجع فرقًا صغيرًا

   بعد أن عدّلت بضعة أسطر وتريد تعليقًا على الفرق لا إعادة هيكلة.

   الصق [قبل] و[بعد] لنفس الدالة. في [القصد] ماذا أردت أن يتغير. لا تلصق مئة سطر.

   راجع هذا الفرق فقط.
   القصد: [جملة]
   قل إن كان القصد تحقق.
   أشر إلى سطر قد يكسر حالة لم أذكرها، بسؤال لا بملف جديد.
   لا تعد كتابة الدالة إلا إذا كان الخطأ الإملائي في اسم واحد، وعندها غيّر ذلك الاسم فقط.
   قبل:
   [النص]
   بعد:
   [النص]

4. ٤. سمِّ المفهوم قبل أن أكمل

   حين يعمل الكود ولا تعرف اسم الفكرة، فتصعب عليك قراءة الدرس التالي.

   الصق [السطر] الذي حيّرك. اسأل عن مفهوم واحد لا عن دورة.

   ما اسم المفهوم الذي يستخدمه هذا السطر، بجملة تعريف وبسطر يوضح لماذا كُتب هنا.
   لا تعطني بدائل.
   لا تنتقل إلى مفهوم ثانٍ.
   اللغة: [الاسم]
   السطر:
   [الصقه]
   إن كان السطر ملتبسًا فاسأل ماذا يطبع عندي ولا تخترع سياقًا.

5. ٥. من مطلب عربي إلى خطوات لا إلى مستودع

   حين الفكرة في رأسك جملة عربية وتريد تفكيكها قبل كتابة أي ملف.

   اكتب [المطلب] كفعل واحد، مثل «صفحة تعرض ثلاثة روابط». ارفض في [لن أبني] ما لا تريد أن يقترحه، مثل حسابات مستخدمين.

   حوّل المطلب إلى خطوات أفعلها أنا في ملف واحد.
   المطلب: [جملة]
   لن أبني الآن: [حد]
   أربع خطوات كحد أقصى.
   كل خطوة تسمية ملف أو وسم أو دالة، لا أمر شراء أداة.
   لا تنشئ هيكل مشروع.
   إن كان المطلب مشروعًا كاملًا فقل «ضيّق» واقترح تضييقًا واحدًا.

6. ٦. اشرح سطرًا داخل دالة تعمل

   حين نسخت مثالًا من درس رسمي وتريد فهم سطر قبل أن تعدّله.

   اذكر [مصدر المثال] إن كان درسًا، أو قل «مثال كتبته». حدد [رقم السطر] أو الصق السطر وحده تحت [السطر].

   اشرح هذا السطر فقط داخل الدالة.
   اللغة: [الاسم]
   مصدر المثال: [الدرس أو «كتبته»]
   ماذا يفعل السطر، وماذا يحدث إن حذفته، في جملتين.
   لا تحسّن المثال.
   الدالة:
   [قصيرة]
   السطر:
   [واحد]

7. ٧. ثلاث حالات أجربها بيدي

   بعد أن صارت الدالة تعمل على مثال واحد، حتى لا تصدق مثالًا سعيدًا فقط.

   صف [الدالة] بجملة ماذا تعيد. لا تطلب توليد اختبارات إطار عمل إن كنت لم تستخدم إطارًا.

   اقترح ثلاث حالات أجربها يدويًا على الدالة: حالة طبيعية، حالة فارغة، وحالة قيمة غريبة.
   لكل حالة: الدخل المتوقع، وما يجب أن أراه.
   لا تكتب إطار اختبار.
   اللغة: [الاسم]
   وصف الدالة: [جملة]
   مثال يعمل عندي الآن: [دخل وخرج]

8. ٨. لماذا نجح المثال في الدرس وفشل عندي

   حين اتبعت الخطوات والناتج مختلف، وتريد فرق بيئة لا محاضرة.

   اكتب [ماذا فعلت] و[ماذا ظهر]. اذكر [النظام] إن كان الفرق بين المتصفح والحاسوب مهمًا. لا تلصق رمز دخول.

   الدرس نجح في الشرح وفشل عندي.
   ماذا فعلت: [خطوات قصيرة]
   ماذا ظهر: [النص أو «صفحة فارغة»]
   أين أشغّل: [المتصفح أو الطرفية أو محرر أونلاين]
   اسألني سؤالًا واحدًا عن الفرق الأرجح قبل أن تعطيني إصلاحًا.
   لا تفترض أنني أخطأت في الإصدار إلا إذا قلت لك إنني لا أعرفه، وعندها اسأل ولا تجزم.

9. ٩. اسم أوضح لمتغير

   حين الكود يعمل والأسماء x وdata وtemp تعطل القراءة.

   الصق [الدالة] القصيرة. في [المجال] قل ماذا تمثل البيانات: درجات، أسماء ملفات، أسعار كتبتها للتدريب.

   اقترح أسماء أوضح للمتغيرات في هذه الدالة من غير تغيير المنطق.
   جدول صغير: الاسم الحالي، الاسم المقترح، ولماذا.
   لا تعد كتابة الدالة كاملة.
   المجال: [ماذا تمثل البيانات]
   الدالة:
   [قصيرة]

10. ١٠. قارن محاولتين كتبتهما

    حين جربت طريقتين وتريد فرق السلوك لا مديحًا للطريقة الأقصر.

    الصق [أ] و[ب]. اكتب [حالة] واحدة يجب أن يتفقا عليها.

    قارن المحاولتين على هذه الحالة: [دخل واحد].
    قولا إن كانتا تعطيان الناتج نفسه.
    اذكر فرقًا واحدًا في الفكرة لا في الأسلوب.
    لا تختر «الأفضل» بشكل عام.
    لا تكتب محاولة ثالثة.
    اللغة: [الاسم]
    أ:
    [الكود]
    ب:
    [الكود]

11. ١١. ارفض المكتبة إن لم أطلبها

    حين تسأل سؤالًا صغيرًا فيقترح النموذج حزمة وتنصيبًا وأنت ما زلت في أول الدرس.

    اكتب [المسموح] صراحة: «لغة فقط من غير مكتبات» أو اسم المكتبة التي تستخدمها فعلًا.

    أجب عن السؤال التالي ضمن هذا القيد: [لغة فقط أو اسم مكتبة أستخدمها].
    إن كان الجواب يحتاج مكتبة خارج القيد فقل «خارج القيد» وقف.
    لا تعطِ أمر تنصيب.
    السؤال:
    [سؤالك]
    ما جربته:
    [سطر]

12. ١٢. حوّل الخطأ إلى سؤال أبحث عنه

    حين تريد جملة بحث تضعها في محرك أو في توثيق اللغة، لا حلًا فوريًا.

    الصق [الرسالة]. احذف المسارات التي فيها اسم مستخدم جهازك واستبدلها بـ [مجلد].

    من رسالة الخطأ هذه، أعطني سؤال بحث واحدًا وجملة أبحث بها في توثيق [اللغة].
    لا تعطِ الإصلاح.
    أشر إلى الكلمة في الرسالة التي يجب أن تبقى في البحث كما هي.
    احذف من اقتراحك أي مسار ملفات.
    الرسالة:
    [النص]

13. ١٣. أسبوع مفهوم واحد

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

    اكتب [ما أعرفه] بصراحة و[المفهوم] الذي اخترته، لا «كل الويب». سبعة أيام حد أقصى في الطلب.

    اقترح خطة أربعة أيام لمفهوم واحد.
    ما أعرفه: [جملة]
    المفهوم: [واحد]
    كل يوم: تمرين واحد أكتبه أنا، موصوف بجملة، من غير حل.
    لا تضف إطار عمل.
    لا جدول ساعات.
    إن كان المفهوم أوسع من أربعة أيام فضيّقه في سطر قبل الخطة.

14. ١٤. تعليق أراجعه قبل أن أحفظ

    بعد أن اشتغل الكود وتريد تعليقًا يذكرك لماذا السطر موجود، لا مقالًا فوق كل سطر.

    الصق [الدالة]. حدد [السطر] الذي سينساه مستقبلك. اطلب تعليقًا واحدًا لا توثيق ملف.

    اكتب تعليقًا عربيًا من سطر واحد فوق هذا السطر يشرح القصد لا بديهيات النحو.
    ممنوع تعليق مثل «هذا متغير».
    إن كان السطر واضحًا من غير تعليق فقل «لا تعليق» ولا تؤلف.
    اللغة: [الاسم]
    الدالة:
    [قصيرة]
    السطر:
    [واحد]

كيف تحسّن الجواب

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

حدود لا نتجاوزها

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

لا تلصق أسرارًا ولا قواعد بيانات عملاء ولا توكنات. غطِّها حتى في صورة الشاشة. الشرح لا يحتاجها. وإن طلب منك الأمر «الصق ملف البيئة حتى أصلح» فارفض؛ هذا الطلب نفسه غلط. حدود اللصق العامة في دليل ما لا يُلصق، ومسار الصفحة الواحدة يكفي مرحلة البداية من غير مشروع كامل.