المكاسب:
- القدرة على تحويل الملاحظات المتفرقة إلى تقرير يحتوي على عنوان واضح وخطوات إعادة الإنتاج الحتمية والنتائج المتوقعة/الفعلية والأدلة بدعم من الذكاء الاصطناعي
- القدرة على فرض قاعدة "استخدام المعلومات التي أقدمها فقط، وعدم اختلاقها" على الذكاء الاصطناعي وضمان إمكانية التكاثر من خلال سيطرته الخاصة
- القدرة على التمييز بين الخطورة (التأثير الفني) والأولوية (إلحاح العمل) وإعطاء العلامة النهائية في سياق العمل
الخطأ الذي يجده المختبر لا يكون ذا قيمة إلا إذا تم إصلاحه؛ يعتمد إصلاحه إلى حد كبير على جودة تقرير الخطأ، وهو سجل يوثق الخلل بطريقة يمكن للمطور فهمه وإعادة إنتاجه وإصلاحه. سيؤدي تقرير الخطأ المكتوب بشكل سيئ ("تسجيل الدخول لا يعمل") إلى تعطيل المطور لساعات، ويؤدي إلى مراسلات ذهابًا وإيابًا، وغالبًا ما يتم إغلاقه لأنه "لا يمكن إعادة الإنتاج". يتضمن التقرير الجيد خطوات واضحة ونتائج متوقعة وفعلية ومعلومات وأدلة سياقية. الذكاء الاصطناعي (AI) جيد جدًا في تحويل ملاحظاتك المتناثرة إلى تقرير احترافي ومنظم. لكن التحذير المركزي ينطبق هنا أيضًا: لا يمكن للذكاء الاصطناعي أن يختلق خطوات لا تراها؛ يمكنهم ملء المعلومات المفقودة بتخمينات "معقولة المظهر" ولكنها غير دقيقة. مهمتك هي التأكد من أن كل سطر من التقرير يستند إلى ما لاحظته بالفعل.
تشريح تقرير الأخطاء الجيد
يتضمن التقرير الفعال هذه العناصر:
- العنوان: قصير ومحدد وقابل للبحث. ليس "هناك خطأ"؛ "تعذر النقر على زر "الخروج" مع وجود أكثر من 10 عناصر في سلة التسوق (Chrome)".
- خطوات إعادة الإنتاج: مرقمة، يمكن تتبعها من الصفر، حتمية. يجب أن يتمكن المطور من رؤية الخطأ بعد اتباع هذه الخطوات.
- النتيجة المتوقعة: ما كان ينبغي أن يحدث وفقاً لمعايير القبول.
- النتيجة الفعلية: ما حدث (رسالة خطأ، شاشة، سلوك).
- البيئة: المتصفح/الجهاز، الإصدار، البيئة (اختبار/مباشر)، دور المستخدم، البيانات.
- الدليل: لقطة الشاشة، الفيديو، السجل، تتبع الأخطاء (تتبع المكدس).
- الخطورة والأولوية: مفصلة أدناه.
نصيحة: قبل إرسال تقرير، اسأل "إذا أعطيت هذه الخطوات لشخص آخر، فهل يمكنه رؤية الخطأ دون مساعدتي؟" بسأل. إذا كانت الإجابة "لا" فإن التقرير غير كامل. يمكن للذكاء الاصطناعي أن يجعل التقرير جميلاً، لكن أنت وحدك من يستطيع ضمان إمكانية تكرار نتائجه.
العنف والأولوية: مفهومان مشوشان
الخطورة هي التأثير الفني للخطأ: هل يتعطل النظام، أو يتم فقدان البيانات، أم أنه خطأ مطبعي؟ الأولوية هي مدى ضرورة إصلاحها بشكل عاجل؛ يتعلق الأمر بتأثير الأعمال. لا يسير الاثنان دائمًا في نفس الاتجاه: الخطأ الإملائي في اسم الشركة على الصفحة الرئيسية يعد أمرًا منخفض الخطورة ولكنه ذو أولوية عالية (السمعة). في حالة حافة نادرة، قد يكون الانهيار شديد الخطورة ولكن ذو أولوية منخفضة. يساعدك الذكاء الاصطناعي على إجراء هذا التمييز عند تقديم الملاحظة؛ ولكن يتم إعطاء التسمية النهائية من قبلك الذي يعرف سياق العمل.
العنف
مثال
الأولوية
مثال
حرجة (مانع)
لا يمكن إكمال الدفع
عاجل (P1)
فقدان الدخل في العيش
عالية (رئيسي)
التقرير يعطي إجمالي غير صحيح
عالي (P2)
لا بد منه للإصدار القادم
متوسطة (ثانوية)
خطأ في حالة الحافة النادرة
متوسطة (ف3)
في سباق السرعة المخطط لها
منخفض (تافه)
تم إيقاف محاذاة الزر
منخفض (P4)
عندما تكون هناك فرصة
موجه ضعيف / موجه قوي
ضعيف: "أبلغ عن هذا الخطأ: الدفع لا يعمل."
قوي: "ترجم ملاحظاتي أدناه إلى تنسيق تقرير الخطأ القياسي: العنوان، خطوات إعادة الإنتاج (مرقمة)، النتيجة المتوقعة، النتيجة الفعلية، البيئة، الخطورة والتوصية ذات الأولوية (مبررة). استخدم فقط المعلومات التي أقدمها؛ قم بتعويض أي حقول مفقودة، ضع علامة "المعلومات المفقودة: ...". الملاحظات: Chrome 120، بيئة الاختبار، 12 عنصرًا في سلة التسوق، لا يحدث شيء عندما أضغط على "الخروج"، خطأ "غير محدد ليس وظيفة" في وحدة التحكم، لا توجد مشكلة في 11 منتج."
موجه قوي؛ يفرض التنسيق وقاعدة "الملاءمة" ووضع علامة على المعلومات المفقودة. بهذه الطريقة، سيكون التقرير دقيقًا وصادقًا.
كشف الأخطاء المكررة
في الفرق الكبيرة، يتم الإبلاغ عن نفس الخطأ مرارًا وتكرارًا. يستطيع الذكاء الاصطناعي مقارنة تقريرك الجديد بالأخطاء المفتوحة الموجودة والإبلاغ عن التكرارات المحتملة - وهذا يحافظ على نظافة نظام تتبع الأخطاء (Jira وAzure DevOps وGitHub Issues). لكن احذر: قد يكون لخطأين يبدوان متشابهين على السطح أسباب جذرية مختلفة؛ قارن بين خطوات الإنتاج المتكررة وبيئة كلا التقريرين قبل إغلاق اقتراح الذكاء الاصطناعي "المكرر". "النسخة المكررة" التي تم إغلاقها عن طريق الخطأ تفتقد في الواقع خطأً منفصلاً.
من تتبع الأخطاء إلى السبب الجذري: قوة الذكاء الاصطناعي في قراءة السجلات
غالبًا ما يكون الجزء الأكثر تقنية في تقرير الخطأ هو تتبع الخطأ (تتبع المكدس - تفصيل أي سطر من التعليمات البرمجية، وسلسلة الاتصال، التي تسببت في حدوث خطأ). يمكن للسجلات الطويلة والمعقدة أن تتعب حتى المطور. يقرأ الذكاء الاصطناعي سجلاً يتكون من مئات الأسطر ويلخص في ثوانٍ الأسطر الأكثر أهمية، وفرضية السبب الجذري المحتمل، ونقطة الكود التي حدث فيها الخطأ. يؤدي هذا إلى تقصير التقرير ويمنح المطور نقطة بداية مباشرة.
تذكر اثنين من الحدود، رغم ذلك. أولاً، السبب الجذري الذي قدمه الذكاء الاصطناعي هو فرضية، وليس دليلاً؛ يجب ألا يحاول المطور إصلاح ذلك دون التحقق منه. ثانيًا، غالبًا ما تحتوي السجلات على بيانات شخصية (البريد الإلكتروني، معرف المستخدم، الرمز المميز للجلسة)؛ قم بإخفاء هذه المناطق قبل وضع السجل على السيارة. من الممارسات الجيدة أن تطلب من الذكاء الاصطناعي أولاً أن يقول "أدرج الحقول التي تحتاج إلى إخفاءها في هذا السجل" ثم قم بتحليل السجل المنظف.
نصيحة: بدلاً من لصق السجل بأكمله في التقرير، قم بتضمين الأسطر الثلاثة إلى الخمسة الأكثر أهمية التي يلخصها الذكاء الاصطناعي ورابطًا إلى السجل الكامل. بهذه الطريقة يظل التقرير قابلاً للقراءة، ويمكن للمطور الذي يحتاج إلى التفاصيل الوصول إلى السجل الكامل.
أربعة قوالب قابلة للنسخ
1) من الملاحظة إلى التقرير:
دورك: كبير ضمان الجودة. قم بترجمة الملاحظات الأولية التالية إلى تقرير خطأ قياسي: العنوان / خطوات الاستنساخ (مرقمة) / المتوقعة / الفعلية / البيئة / مذكرة الأدلة / الخطورة + الأولوية (مبررة). القاعدة: استخدم فقط المعلومات التي أقدمها؛ ضع علامة على الحقل المفقود كـ "معلومات مفقودة:..." ملاحظات: [ملاحظات أولية]
2) التحكم في الاستنساخ:
اقرأ تقرير الخطأ هذا من وجهة نظر المطور الذي لم يسبق له رؤية الخطأ. اتبع الخطوات وقم بوضع علامة على الأماكن التي لن ينتج عنها الخطأ: خطوة غامضة، شرط أساسي مفقود، بيانات اختبار مفقودة، شرط تم تخطيه. أخبرني ما هي المعلومات التي يجب أن أضيفها لكل فجوة. تقرير: [لصق التقرير]
3) مستشار الخطورة/الأولوية:
أصف الخطأ التالي: [خطأ + سياق العمل]. قدم اقتراحات ومبررات بشكل منفصل لشدة الخطورة (التأثير الفني) والأولوية (إلحاح العمل). اشرح لماذا قد يكون الاثنان مختلفين. سأتخذ القرار النهائي.
4) ملخص تتبع السجل/الخطأ:
افحص تتبع/سجل الخطأ أدناه. أعطني ملخصًا عن (1) فرضية السبب الجذري، (2) نقطة الرمز المحتملة التي حدث فيها الخطأ، (3) الأسطر الثلاثة الأكثر أهمية التي يجب إضافتها إلى التقرير. قم بإخفاء البيانات الشخصية إذا كانت هناك بيانات شخصية.السجل: [لصق السجل]
ثلاث حالات صغيرة
الحالة الأولى - التحرر من "لم أستطع الإنتاج". في أحد الفرق، تم إغلاق 30% من الأخطاء لأنها "لا يمكن أن تتكاثر". تمت إضافة قالب "فحص التكرار" إلى عملية التقرير؛ قبل إرسال كل تقرير، قام الذكاء الاصطناعي بوضع علامة على الخطوات والمتطلبات الأساسية المفقودة. وبعد ثلاثة أشهر، انخفض معدل "عدم القدرة على الإنتاج" من 30% إلى 8%. وكان الفرق هو أن الخطوات كانت دقيقة من البداية.
الحالة الثانية – خطورة الخطوات الوهمية. طلب أحد المختبرين من الذكاء الاصطناعي كتابة تقرير يحتوي على ملاحظات غير مكتملة؛ أضاف الذكاء الاصطناعي خطوة لم تحدث أبدًا، مثل "يقوم المستخدم بتشغيل الإشعارات من صفحة الإعدادات". وعندما اتبع المطور هذه الخطوة، لم يتمكن من العثور على الخطأ وضيع الوقت. قام الفريق بفرض قاعدة "استخدام المعلومات التي أقدمها فقط، وعدم اختلاقها"؛ يتم التخلص من الخطوات المصنوعة.
الحالة 3 - تمييز الخطورة/الأولوية. حدث خطأ مطبعي في شعار الشركة على الصفحة الرئيسية. سوف يمرر المختبر هذا على أنه "منخفض" ؛ وذكر مستشار الذكاء الاصطناعي أن العنف التقني منخفض ولكن أولوية العمل عالية (عنصر السمعة الذي يتلقاه كل زائر). تم إصلاح الخلل في نفس اليوم باستخدام علامة "الأولوية العالية".
الأخطاء الشائعة
- عنوان غامض. عناوين غير قابلة للبحث وغير تمييزية مثل "لا تعمل".
- الخطوات المفقودة / التي تم تخطيها. عدم كتابة ما هو واضح في السياق الخاص بك؛ فشل المطور في الإنتاج.
- السماح للذكاء الاصطناعي باختلاق الأمر. ملء المعلومات المفقودة بـ "تقدير معقول"؛ خطوات خاطئة.
- عدم كتابة النتيجة المتوقعة. قول "خطأ" ولكن دون تحديد ما هو صواب.
- الخلط بين العنف والأولوية. الخلط بين الاثنين كتسمية واحدة؛ سوء تقدير تأثير الأعمال.
- البيانات الحساسة في الأدلة. مشاركة البيانات الشخصية الحقيقية في لقطات الشاشة/السجلات دون إخفاءها.
باختصار
تتمثل قيمة تقرير الخطأ في أنه يمكن للمطور إعادة إنتاج الخطأ وإصلاحه دون مساعدتك. الذكاء الاصطناعي جيد جدًا في تحويل الملاحظات المتفرقة إلى تقرير احترافي ومنظم؛ وينظم العنوان والخطوات والنتيجة المتوقعة/الفعلية والبيئة والأدلة، ويقدم الاستشارات حول التمييز بين الخطورة والأولوية. لكن الذكاء الاصطناعي يمكنه تعويض المعلومات المفقودة؛ قم بتطبيق قاعدة "استخدام المعلومات التي أقدمها فقط، ووضع علامة على المعلومات المفقودة" وضمان إمكانية التكرار بنفسك. إخفاء البيانات الشخصية في الأدلة.
مهمة التطبيق
خذ الخطأ الذي اكتشفته مؤخرًا وقم بتحويل ملاحظاتك الأولية إلى تقرير باستخدام نمط "الملاحظة للإبلاغ" (مع قاعدة "الملاءمة"). ثم قم بإجراء "فحص التكرار" واملأ الفجوات المحددة. قم بإعطاء التقرير إلى زميل لك ومعرفة ما إذا كان يمكنه إنتاج الخطأ دون مساعدتك. أخيرًا، حدد التصنيفات مع "استشاري العنف/الأولوية" وقم بوضع اللمسات الأخيرة عليها وفقًا لتقديرك الخاص. قم بتدوين أي معلومات يحاول الذكاء الاصطناعي تعويضها في هذه العملية.
قائمة مرجعية
- [ ] عنواني محدد وقابل للبحث.
- [ ] خطوات الاستنساخ هي من الصفر وحتمية وكاملة.
- [ ] كتبت النتائج المتوقعة والفعلية بشكل منفصل.
- [ ] معلومات الإعداد والأدلة كاملة؛ لقد قمت بإخفاء البيانات الشخصية.
- [ ] لقد فرضت قاعدة "التعويض، تحديد المفقودات" على الذكاء الاصطناعي وملأت الفجوات بنفسي.
- [ ] قمت بتقييم مدى الخطورة والأولوية بشكل منفصل واتخذت القرار النهائي.