برومبتات لإصلاح الأخطاء: كيف تشرح المشكلة للوكيل

كيف تشرح المشكلة للوكيل ليصلحها من أول مرة؟

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

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

الخطأ الموصوف بدقة نصفه مُصلح.

قالب بلاغ الخطأ: انسخه واملأه

استخدم هذا القالب لكل مشكلة على حدة. لا تجمع ثلاثة أخطاء في رسالة واحدة؛ كل خطأ يستحق بلاغاً مستقلاً واختباراً مستقلاً.

خطأ أم طلب تغيير؟

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

بلاغ ضعيف وبلاغ قوي: أمثلة حقيقية الشكل

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

كيف تجمع الدليل وأنت لست مبرمجاً؟

1. 1
   كرر المشكلة مرة ثانية

   إن تكررت بنفس الخطوات فهي قابلة للإصلاح بسهولة. إن لم تتكرر، اكتب ذلك صراحة مع الوقت التقريبي.

2. 2
   غيّر متغيراً واحداً

   جرّب باللغة الأخرى، أو بدور آخر، أو من جهاز آخر. «يحدث بالعربي فقط» معلومة ذهبية.

3. 3
   انسخ النص لا تلخّصه

   رسالة الخطأ كما ظهرت، حتى لو كانت بالإنجليزية وغير مفهومة لك.

4. 4
   التقط صورة للشاشة

   خصوصاً لمشاكل التصميم والاتجاه؛ صورة واحدة تغني عن فقرة.

5. 5
   حدد بيانات الاختبار

   رقم الطلب، اسم المنتج، أو حساب الاختبار الذي استخدمته، حتى يجد الوكيل الحالة نفسها.

ماذا تفعل إذا لم ينجح الإصلاح؟

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

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

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

امنع عودة الخطأ: الاختبار بعد كل إصلاح

أخطر ما في الإصلاح أن يكسر شيئاً آخر دون أن تنتبه. احتفظ بقائمة قصيرة من السيناريوهات الأساسية لتطبيقك، واطلب إعادة اختبارها بعد كل إصلاح مهم:

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

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

برومبتات جاهزة لأخطاء شائعة في التطبيقات الخليجية

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

• التاريخ الهجري: «التاريخ الهجري في صفحة الحجز يختلف بيوم عن التقويم الرسمي في السعودية. وضّح لي أي طريقة حساب تستخدم، واجعلها مطابقة لتقويم أم القرى.»
• أرقام الجوال: «إذا كتب العميل رقمه بالأرقام العربية الهندية أو بمسافات أو بصيغة 966+، حوّله لصيغة موحدة قبل الحفظ وإرسال الرمز.»
• الضريبة: «في الفاتورة، اجمع الضريبة على مستوى الطلب لا لكل منتج مع التقريب، وأظهر المبلغ قبل الضريبة والضريبة والمجموع بوضوح. اختبر بطلب فيه 3 منتجات بأسعار كسرية.»
• بعد الدفع: «إذا أغلق العميل الصفحة بعد الدفع مباشرة، الطلب يبقى غير مدفوع. تأكد أن تأكيد الدفع يُسجل من إشعار بوابة الدفع وليس من صفحة الشكر فقط.»
• الاتجاه: «في صفحة الدفع بالعربي، حقل البريد الإلكتروني يُكتب من اليمين. اجعل حقول البريد ورقم البطاقة من اليسار دائماً.»
• واتساب: «رسالة التأكيد على واتساب لا تصل للطلبات بعد منتصف الليل. افحص التوقيت والمنطقة الزمنية المستخدمة (توقيت الرياض).»

أسئلة شائعة

مصطلحات في هذا المقال