أعطِ الذكاء الاصطناعي ما يحتاجه
البلاغ ذو الأجزاء الثلاثة
الذكاء الاصطناعي (AI) لا يرى شاشتك. ولا يعرف ما الذي ضغطت عليه، وليس لديه أي ذاكرة عن جلستك السابقة ما لم تزوّده بها. لذلك أعطه الأشياء الثلاثة نفسها التي كنت ستعطيها لزميل: ما الذي فعلته، وما الذي توقّعته، وما الذي حدث فعلًا. «ملأت نموذج الحجز وضغطت تأكيد. توقّعت صفحة تأكيد ورسالة بريد إلكتروني. لكن الصفحة أصبحت فارغة، وظهر هذا في Console: [الرسالة كاملة].» هذا البلاغ كافٍ للعمل عليه. قارنه بعبارة «الحجز معطّل»، التي تفرض التخمين بين عشرات الأعطال المحتملة. جودة الإصلاح الذي تحصل عليه تتحدّد بالكامل تقريبًا بجودة هذا الوصف.
- ما الذي فعلته، وما الذي توقّعته، وما الذي حدث فعلًا — في كل مرة
- لا يرى شاشتك؛ لا شيء واضح ما لم تقله
- أرفق نص الخطأ كاملًا بالبلاغ بدل أن تصفه
- الإصلاح الذي يعود إليك لا يكون أفضل من الوصف الذي قدّمته
قل ما الذي تغيّر منذ آخر مرة نجح فيها
أضف شيئًا آخر كلما استطعت: ما الذي كان مختلفًا آخر مرة كان يعمل فيها. «كان يعمل قبل أن أطلب منك إضافة فلتر التاريخ» تضيّق نطاق البحث كثيرًا، لأن السبب على الأرجح داخل ذلك التغيير. وإن كنت تُجري عدة تغييرات دون التحقق، فلن تملك هذه المعلومة. هذا هو السبب العملي للتحقق بعد كل تغيير. ومن المفيد أيضًا أن تذكر أشياء تبدو غير ذات صلة: حدّثت شيئًا، أو نقلت ملفًا، أو كنت على شبكة مختلفة. المبتدئون يُسقطون باستمرار التفصيل الذي يتبيّن أنه المهم، بحجة أنه لا يمكن أن يكون مرتبطًا. قله على أي حال، ودع الذكاء الاصطناعي يقرّر.
- سمِّ آخر تغيير أُجري قبل العطل — غالبًا هو السبب
- اذكر أي شيء آخر تغيّر، حتى لو بدا غير مرتبط
- التحقق بعد كل تغيير هو ما يُبقي هذه المعلومة متاحة
- التفصيل الذي تظنه غير مهم غالبًا هو المهم
اسأله ماذا يفعل
حين يعود إليك إصلاح، اطرح سؤالًا قصيرًا قبل أن تقبله: ما الذي كان خاطئًا، وما الذي غيّرته؟ أنت لا تراجع الكود. أنت تبني صورة ذهنية عن مشروعك، وسجلًا مكتوبًا تستطيع الرجوع إليه. وهذا يكشف أيضًا عطلًا محددًا يستحق الكشف: الإصلاح الذي يعالج العَرَض بحذف الميزة. فهو يحذف بهدوء الفحص الذي كان يفشل بشكل مزعج، بدل أن يجعله ينجح. شرح من فقرة واحدة بلغة بسيطة يكلّفك خمس عشرة ثانية. وعلى مدى أسابيع يحوّل كومة ملفات غامضة إلى شيء لديك عنه خريطة تقريبية على الأقل.
- اسأل دائمًا ما الذي كان خاطئًا وما الذي تغيّر، بلغة بسيطة
- انتبه للإصلاحات التي تحذف الميزة بدل أن تصلحها
- أنت تبني خريطة لمشروعك، لا تراجع الكود
- الشروحات تتراكم لتصبح فهمًا حقيقيًا على مدى أسابيع
جرّب بنفسك
أسوأ لحظة لتتعلّم كيف تبلّغ عن خطأ برمجي (Bug) هي حين يكون شيء معطّلًا. جهّز البلاغ الآن، بهدوء، حتى لا يحتاج «أنت المذعور» لاحقًا إلا إلى ملء الفراغات.
احفظ القالب أدناه كملاحظة بجانب وصف المتطلبات (Spec)، قبل أن يتعطّل أي شيء. وفي المرة القادمة التي يتعطّل فيها شيء، املأ كل سطر قبل أن ترسل أي شيء إلى الذكاء الاصطناعي.
ما الذي فعلته: [الخطوات بالضبط، بالترتيب، وتنتهي بما ضغطت عليه] ما الذي توقّعته: [ما كان يجب أن يحدث] ما الذي حدث بدلًا من ذلك: [ما رأيته فعلًا على الشاشة] رسالة الخطأ كاملة ملصوقة: [الرسالة كلها — أسماء الملفات، وأرقام الأسطر، كل شيء]
- القالب موجود بجانب وصف المتطلبات، جاهز قبل أن يتعطّل أي شيء
- بلاغك التالي أُرسل ومعه نص الخطأ كاملًا ملصوقًا، لا ملخصًا عنه
- الإصلاح الذي عاد استهدف الشيء الصحيح دون جولة تخمين أولًا