ما الذي يجعل تقرير الخطأ جيداً؟
تقرير الخطأ الجيد يتيح لشخص آخر إعادة إنتاج المشكلة دون أن يسأل: عنوان محدد، وخطوات مرقّمة، والنتيجة المتوقعة والفعلية، والبيئة (الإصدار والمتصفح والجهاز والحساب)، والبيانات المستخدمة، وأدلة مثل لقطة شاشة أو سجل. الخطورة تصف الأثر على النظام (انهيار أو فقدان بيانات)؛ والأولوية تصف مدى استعجال العمل لإصلاحه — وتُحددان بشكل منفصل وكثيراً ما تختلفان.
اقرأ الدليل: كيف تكتب تقرير خطأ (Bug Report)
كيفية استخدام مولّد عناوين الأخطاء بالذكاء الاصطناعي
- الصق وصف الخطأ كما لديك — الملاحظات غير المرتبة مقبولة.
- اذكر، إن شئت، المنطقة أو المكوّن (مثل Checkout أو Login API)، واختر عدد العناوين المطلوب (من 3 إلى 6).
- اختر لغة المخرجات ثم اضغط «توليد».
- انسخ العنوان الموصى به أو اختر نمطاً آخر من الخيارات، وأضف الكلمات المفتاحية المقترحة كوسوم في أداة التتبع.
مزايا مولّد عناوين الأخطاء بالذكاء الاصطناعي
- تتبع العناوين اصطلاح "[Area] Symptom when Action under Condition"
- عدة أساليب: موجز، ومفصّل، ومركّز على أثر المستخدم، وتقني
- عنوان موصى به إضافة إلى كلمات مفتاحية/وسوم للبحث
- يعمل انطلاقاً من ملاحظات غير مرتّبة وغير منظّمة
مثال على مولّد عناوين الأخطاء بالذكاء الاصطناعي
الملاحظات ← العنوان
الإدخال:
when i put the discount code twice the total becomes NaN and i cant payالنتيجة:
[Checkout] Order total shows NaN when a discount code is applied twiceالاصطلاح
الجزء 1:[Area]
ملاحظاتك (مُدخل المثال)
الجزء 3:when i put the discount code twice
العنوان الموصى به (مُخرج المثال)
الجزء 1:[Checkout]
- 1المنطقة (Area): المكوّنالملاحظات لا تذكرها، فيضيفها العنوان بين قوسين؛ ويمكنك تسميتها بنفسك في الخطوة 2، مثل Checkout أو Login API.
- 2العَرَض (Symptom): ما الخطأشيء يمكن للمطوّر البحث عنه، لا كلمة مبهمة مثل «مشكلة» أو «لا يعمل».
- 3الإجراء (when Action): ما الذي فُعلالخطوة التي تُظهر العَرَض، وتأتي بعده.
- 4الظرف (under Condition)البيئة أو الظرف، ولا يُضاف إلا عندما يلزم لإعادة إنتاج الخطأ.ليس في هذا المثال
يبقى كل عنوان دون 120 حرفاً.
الأسئلة الشائعة حول مولّد عناوين الأخطاء بالذكاء الاصطناعي
لماذا هذه الصيغة للعنوان؟
تجعل صيغة "[Area] Symptom when Action under Condition" العناوين قابلة للبحث، وتتجنّب التكرارات، وتخبر المطوّر بما هو خاطئ قبل فتح التذكرة.
لماذا تتجنب العناوين كلمات مثل «مشكلة» أو «لا يعمل»؟
لأن هذه الكلمات لا تقول شيئاً يمكن للمطوّر البحث عنه أو العمل عليه. يذكر العنوان العَرَض — ما الخطأ — ولا يتضمن البيئة أو الظرف إلا عندما يلزم لإعادة إنتاج الخطأ.
أي عنوان أستخدم؟
العنوان الموصى به هو الأنسب للوصف الذي قدّمته، وهو دائماً أحد الخيارات المعروضة. واختر نمطاً آخر إذا فضّله فريقك — عنوان أثر المستخدم لتذكرة دعم، أو العنوان التقني لقائمة أعمال المطورين.
ملاحظات تقنية
يتبع كل عنوان صيغة «[Area] Symptom when Action under Condition»، ويبقى دون 120 حرفاً، ويأتي بنمط واحد — موجز أو مفصّل أو يركّز على أثر المستخدم أو تقني — مع مبرر من سطر واحد. ويُنسخ العنوان الموصى به حرفياً من تلك القائمة، وتُقترح حتى ثماني كلمات مفتاحية للوسوم.
المراجع
- ISTQB Glossaryالتعريفات القياسية لمصطلحات الاختبار — حالة الاختبار واختبار الانحدار والخطورة والأولوية وتحليل القيم الحدّية وغيرها.
- Lessons Learned in Software Testing: A Context-Driven Approach (Cem Kaner, James Bach, Bret Pettichord)دروس عملية في الإبلاغ عن الأخطاء وتصميم الاختبارات والأتمتة وإدارة الاختبار — مدرسة الاختبار المدفوع بالسياق.