مركز تعلّم الذكاء الاصطناعيEnglish
ترجمة عربية جديدة ✦ نراجعها باستمرار لتحسينها.

أعطِ الذكاء الاصطناعي ما يحتاجه

⁧أبلغ عنه كما تبلغ زميلًا لم يكن حاضرًا⁩⁧جودة الإصلاح الذي تتلقّاه بقدر جودة وصفك — لا شيء واضح ما لم تقله⁩⁧البلاغ ثلاثي الأجزاء — قله كله، في كل مرة⁩1 · ⁧ما فعلته⁩⁧«ملأت نموذج الحجز وضغطت تأكيد»⁩2 · ⁧ما توقّعته⁩⁧«صفحة تأكيد، وبريدًا إلكترونيًا يصلني»⁩3 · ⁧ما حدث فعلًا⁩⁧«صفحة فارغة — وهذا نص الخطأ كاملًا: [ملصق]»⁩⁧التفصيلة التي تضيّق كل شيء⁩⁧«كان يعمل قبل أن نضيف فلتر التاريخ»⁩⁧السبب يكاد يكون دائمًا داخل ذلك التغيير⁩⁧البلاغ الضعيف⁩⁧«الحجز معطّل» يفرض⁩⁧التخمين بين عشرات الأعطال⁩⁧المحتملة — قل أيّها رأيت⁩⁧اذكر التفاصيل الغريبة أيضًا⁩⁧حدّثت شيئًا، أو نقلت⁩⁧ملفًا، أو غيّرت الشبكة — قلها⁩⁧على أي حال ودع الذكاء الاصطناعي يقرّر⁩⁧حين يعود الإصلاح، اسأل⁩⁧«ما الذي كان خطأ، وما الذي⁩⁧غيّرته؟» — خمس عشرة ثانية⁩⁧تبني خريطتك الخاصة تدريجيًا⁩⁧احذر الإصلاح الذي يحذف الميزة⁩⁧بعض الإصلاحات تُخفي الخطأ بإزالة الفحص الذي كان يفشل — والسؤال هو ما يكشف ذلك⁩⁧ما فعلته · ما توقّعته · ما حدث فعلًا⁩⁧أرفق نص الخطأ كاملًا، واذكر آخر تغيير أُجري قبل العطل⁩
⁧الذكاء الاصطناعي لا يرى شاشتك — أخبره بما فعلته وما توقّعته وما حدث فعلًا، مع نص الخطأ كاملًا.⁩

البلاغ ذو الأجزاء الثلاثة

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

  • ما الذي فعلته، وما الذي توقّعته، وما الذي حدث فعلًا — في كل مرة
  • لا يرى شاشتك؛ لا شيء واضح ما لم تقله
  • أرفق نص الخطأ كاملًا بالبلاغ بدل أن تصفه
  • الإصلاح الذي يعود إليك لا يكون أفضل من الوصف الذي قدّمته

قل ما الذي تغيّر منذ آخر مرة نجح فيها

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

  • سمِّ آخر تغيير أُجري قبل العطل — غالبًا هو السبب
  • اذكر أي شيء آخر تغيّر، حتى لو بدا غير مرتبط
  • التحقق بعد كل تغيير هو ما يُبقي هذه المعلومة متاحة
  • التفصيل الذي تظنه غير مهم غالبًا هو المهم

اسأله ماذا يفعل

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

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

جرّب بنفسك

أسوأ لحظة لتتعلّم كيف تبلّغ عن خطأ برمجي (Bug) هي حين يكون شيء معطّلًا. جهّز البلاغ الآن، بهدوء، حتى لا يحتاج «أنت المذعور» لاحقًا إلا إلى ملء الفراغات.

◆ جرّبها بنفسك

احفظ القالب أدناه كملاحظة بجانب وصف المتطلبات (Spec)، قبل أن يتعطّل أي شيء. وفي المرة القادمة التي يتعطّل فيها شيء، املأ كل سطر قبل أن ترسل أي شيء إلى الذكاء الاصطناعي.

ما الذي فعلته: [الخطوات بالضبط، بالترتيب، وتنتهي بما ضغطت عليه]

ما الذي توقّعته: [ما كان يجب أن يحدث]

ما الذي حدث بدلًا من ذلك: [ما رأيته فعلًا على الشاشة]

رسالة الخطأ كاملة ملصوقة: [الرسالة كلها — أسماء الملفات، وأرقام الأسطر، كل شيء]
كيف تعرف أنها نجحت
  • القالب موجود بجانب وصف المتطلبات، جاهز قبل أن يتعطّل أي شيء
  • بلاغك التالي أُرسل ومعه نص الخطأ كاملًا ملصوقًا، لا ملخصًا عنه
  • الإصلاح الذي عاد استهدف الشيء الصحيح دون جولة تخمين أولًا