# تشخيص أخطاء الكود وكتابة اختبارات مفيدة بمساعدة الذكاء الاصطناعي

> جهّز مثالًا قابلًا لإعادة الخطأ، واطلب إصلاحًا محدودًا، ثم اختبر السلوك المتوقع والحالات الحدّية قبل الدمج.

**Author:** Awamer  
**Published:** 2026-11-11  
**Category:** أدلة تطبيقية

---

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

## جهّز حزمة تشخيص قابلة لإعادة التجربة

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

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

## اطلب فرضيات واختبارًا فاصلًا

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

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

## اكتب اختبارات للسلوك المطلوب

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

استخدم [مخطط اختبارات الدوال](/ar/ai-prompts/function-test-planner) واطلب فصل الحالات عن كود الاختبار. اجعل البيانات واضحة ومحدودة، واعزل الخدمات الخارجية عندما لا تكون جزءًا من السلوك المراد فحصه. شغّل اختبارًا يثبت الفشل قبل الإصلاح، ثم الاختبارات المرتبطة بعده. نجاح اختبار واحد لا يثبت سلامة كل مسارات التطبيق.

## راجع التعديل قبل اعتماده

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

احفظ في وصف التعديل سبب المشكلة، والحالة التي تكشفها، والإصلاح، وما تم اختباره. ويمكن استخدام [قالب تشخيص الأخطاء](/ar/ai-prompts/debug-error-context) للحالات التالية أو [تصميم مخطط قاعدة البيانات](/ar/ai-prompts/database-schema-designer) عندما يتضح أن المشكلة في نموذج البيانات. بهذه الطريقة يصبح التعاون مع المساعد قابلًا للمراجعة، ويظل قرار قبول الكود مبنيًا على أدلة تشغيل واضحة.
