M365Con 2027 – مؤتمر مجاني عبر الإنترنت · 11–22 Jan 2027 · 120 sessions→ m365con.net

المدونة · Mirko Peters

كيف تكتب حالة اختبار بلغة إنجليزية بسيطة يستطيع وكيل ذكاء اصطناعي تنفيذها

By · · Updated

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

Automatically translated with AI from the original post. Read the English original

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

النقاط الرئيسية

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

الأجزاء الخمسة لحالة اختبار بلغة إنجليزية بسيطة

تشبه حالة الاختبار الجيدة قصةً قصيرة يستطيع أي عضو في الفريق متابعتها. وتُعد كتابة حالات اختبار فعّالة مهارةً أساسية في ضمان الجودة في البرمجيات، وقد كتب المختبرون اليدويون حالاتهم بلغة واضحة منذ زمن طويل. الجديد هو أن وكيل ذكاء اصطناعي صار قادراً الآن على تنفيذ خطوات الاختبار. ويبرز ذلك بشكل خاص في end-to-end testing، حيث يتتبع الاختبار مستخدماً عبر سير عمل كامل داخل المتصفح. وبالنسبة إلى AI agent، يجب أن يكون كل جزء صريحاً، لأن الوكيل لا يستطيع أن يسألك عما قصدته.

  1. العنوان. سطر واحد يصف السلوك، مثل "A customer can reset a forgotten password". العنوان هو أول ما يراه القارئ في التقرير.
  2. الشروط المسبقة. الحالة التي يجب أن يكون عليها المنتج قبل بدء الاختبار، مثل "A customer account exists and the customer is signed out".
  3. الخطوات. ما يفعله المستخدم، إجراء واحد في كل سطر.
  4. النتيجة المتوقعة. ما يجب أن يراه المستخدم بعد ذلك، بعبارات يمكنك التحقق منها على الشاشة.
  5. بيانات الاختبار. القيم الدقيقة المستخدمة، مثل عنوان بريد إلكتروني أو رقم طلب.

يُبقي القالب الموحّد حالات الاختبار لكل مختبر بالشكل نفسه، ومجموعة الاختبارات التي تعتمد قالباً واحداً أسهل بكثير في المراجعة. كما تحتاج حالة الاختبار إلى وسيلة للتحقق من النتيجة، ولهذا تكتسب النتيجة المتوقعة أهميتها.

هذا هو الشكل نفسه الذي تعتمده التطوير المدفوع بالسلوك. ففي لغة Gherkin، كما يشرح ذلك موقع Automation Panda، تحدد الكلمة Given الحالة الابتدائية، وتنفّذ When الإجراء محل الاختبار، وتصف Then النتيجة المتوقعة. ولست بحاجة إلى استخدام هذه الكلمات المفتاحية، فالأدوار الثلاثة تبقى مفيدة.

قواعد تجعل الخطوة قابلة للتنفيذ بواسطة وكيل ذكاء اصطناعي

أصدرت شركات تطوير الأدوات إرشادات لكتابة تعليمات يمكن لوكيل الذكاء الاصطناعي اتباعها. وتقدّم وثائق BrowserStack الخاصة بـ وكيل اختبار اللغة الطبيعية قواعد تنطبق على معظم الأدوات:

  • ابدأ بفعل أمر. "Click the Submit button" واضحة. أما "The submit button" فليست تعليمة.
  • استخدم هدفاً واحداً لكل أمر. قسّم المهام متعددة الخطوات إلى خطوات منفصلة.
  • سمِّ العنصر المحدد. اكتب "the Log In button"، لا "the button".
  • مرّر الشاشة أولاً عندما يكون الهدف خارج نطاق الشاشة. أضف خطوة قبل الإجراء.

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

  • استخدم الكلمات الظاهرة على الشاشة. إذا كان الزر يحمل العبارة "Sign in"، فلا تكتب "Log in".
  • ضمّن القيم في الخطوة. اكتب "Type ana@example.com into the Email field"، لا "enter a valid email".
  • تجنّب الضمائر والكلمات الغامضة. فكلمات "It" و"there" و"properly" و"correctly" تُخفي قراراً يضطر الوكيل إلى تخمينه.

كيفية كتابة حالات الاختبار بلغة إنجليزية بسيطة، خطوة بخطوة

اتبع هذه الطريقة لتحويل المتطلب إلى حالة اختبار.

  1. ابدأ من معيار قبول واحد. خذ جملة واحدة من قصة المستخدم، مثلاً "A customer who forgets a password can set a new one by email".
  2. حدّد سلوكاً واحداً. كل حالة اختبار تتحقق من سلوك واحد. ويصوغ دليل Automation Panda حول كتابة Gherkin الجيدة هذا المبدأ بعبارة "One Scenario, One Behavior"، ويذكر أن السيناريو الذي يحتوي على عدة أزواج When-Then ينبغي تقسيمه.
  3. اكتب الحالة الابتدائية. صفها كحالة لا كإجراءات إعداد. فالعبارة "A customer account exists" أفضل من عشر خطوات تنشئ حساباً واحداً.
  4. اكتب إجراءات المستخدم. كل إجراء سطر قصير واحد يتضمن فعلاً وعنصراً محدداً.
  5. اكتب النتيجة المتوقعة. حدّد ما يظهر: عنوان أو رسالة أو قيمة. واستخدم النص الدقيق.
  6. أضف البيانات. ضع القيم في الخطوات أو في جدول صغير أسفل الاختبار.
  7. اقرأها بصوت عالٍ. إذا لم يستطع زميل جديد تنفيذها يدوياً، فسيواجه الوكيل الصعوبة نفسها.

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

مثال: اختبار إعادة تعيين كلمة المرور، قبل التعديل وبعده

البيانات الواردة هنا من نسج الخيال.

قبل (غامض أكثر من اللازم). "Check that password reset works." لا يملك الوكيل حالة ابتدائية ولا إجراءات ولا نتيجة يتحقق منها. وقد ينجح الاختبار لسبب خاطئ.

بعد (قابل للتنفيذ).

  • العنوان: يمكن للعميل طلب رابط لإعادة تعيين كلمة المرور.
  • الشرط المسبق: يوجد حساب عميل للبريد ana@example.com، والعميل مسجّل الخروج.
  • الخطوة 1: افتح صفحة Sign in.
  • الخطوة 2: انقر على رابط "Forgot password".
  • الخطوة 3: اكتب ana@example.com في حقل Email.
  • الخطوة 4: انقر على الزر "Send reset link".
  • النتيجة المتوقعة: تعرض الصفحة الرسالة "Check your email".

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

الآن شغّل الاختبار واقرأ السجل. لنفترض أن الوكيل نقر على "Forgot password" بشكل صحيح، لكنه كتب العنوان في مربع بحث. يُظهر السجل الخطأ، فتعيد كتابة الخطوة 3 لتصبح "Type ana@example.com into the Email field on the reset form". ويوصي فريق Cypress بالعادة نفسها في أداته الخاصة بالإنجليزية البسيطة: افحص كل خطوة مولَّدة، وانتقل إلى كود ثابت (eject) عندما تحتاج إلى اختبار مستقر.

الاختلافات: استخدم جدول بيانات، لا نسخاً

كثير من حالات الاختبار تتحقق من السلوك نفسه بقيم مختلفة. ينبغي أن يرفض نموذج التسجيل عنوان بريد إلكتروني بدون علامة @، وآخر بدون نطاق، وثالثاً يحتوي على مسافات. لا تكتب ثلاث حالات اختبار بخطوات متطابقة.

يشير دليل Automation Panda إلى أن Gherkin لا يحتوي على خطوة "Or". ولتغطية متغيرات لسلوك واحد، يوصي الدليل بـ Scenario Outline مع جدول Examples، وينصح بتضمين المتغيرات التي تحتاجها فقط، لأن الصفوف الإضافية تزيد من وقت التشغيل. يمكنك تطبيق الفكرة نفسها باللغة الإنجليزية العادية: اكتب الخطوات مرة واحدة باستخدام عنصر نائب، مثل "Type {email} into the Email field"، ثم أضف جدولاً صغيراً أسفلها.

جدول أمثلة توضيحي: {email} هي "ana.example.com" والرسالة المتوقعة هي "Enter a valid email address"؛ و{email} هي "ana@" والرسالة نفسها؛ و{email} فارغة والرسالة هي "Email is required". ثلاثة صفوف، ومجموعة واحدة من الخطوات، وثلاث نتائج واضحة. وإذا فشل صف واحد، يُظهر التقرير القيمة التي أخلّت بالقاعدة.

قائمة مراجعة قبل التشغيل

استخدم هذه القائمة مع كل حالة اختبار جديدة:

  • يذكر العنوان سلوكاً واحداً.
  • تصف حالة البداية حالةً، لا قائمة بنقرات الإعداد.
  • تبدأ كل خطوة بفعل وتسمي العنصر كما تظهر على الشاشة.
  • تُكتب جميع القيم بشكل صريح.
  • يمكن رؤية النتيجة المتوقعة، وتتضمن نصاً أو رقماً دقيقاً.
  • تحتوي على أقل من عشر خطوات.
  • قرأها شخص آخر.

الأخطاء الشائعة

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

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

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

الخطوة التالية

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

Entities in this article

End-to-end testing AI agent Generative AI

Related articles

RSS