مركز تعلّم الذكاء الاصطناعيEnglish
ترجمة عربية جديدة ✦ نراجعها باستمرار لتحسينها.
◆ وصف ما تريده

كتابة وصف المتطلبات بلغة بسيطة

⁧وصف المتطلبات ثلاثة أسئلة وخط نهاية، بجمل عادية⁩⁧لا حاجة لوثيقة تقنية — الافتراضات غير المذكورة ليست ضمنية، بل غائبة ببساطة⁩⁧وصف المتطلبات كاملًا — صفحة واحدة، جمل بسيطة⁩⁧لمن هو؟⁩⁧شخص محدّد — جهازه، وما يعرفه⁩⁧مسبقًا، ومقدار صبره⁩⁧ماذا يجب أن يفعل؟⁩⁧الإجراءات التي يمكن للمستخدم القيام بها، بوضوح،⁩⁧وبالترتيب الذي تحدث به⁩⁧ما الذي يجب ألّا يفعله أبدًا؟⁩⁧الجزء الذي يتجاوزه الناس — إن لم تقل إن الزوار⁩⁧لا يرون مُدخلات بعضهم، فلا شيء يفترض ذلك⁩⁧ما الذي يتحقق عند اكتماله⁩⁧5–10 عبارات تتحقق منها في أقل من دقيقة،⁩⁧تكتبها قبل البناء، وذهنك ما زال صافيًا⁩⁧الصق وصف المتطلبات كاملًا⁩⁧سياقًا، في كل جلسة⁩⁧اطلب جزءًا صغيرًا واحدًا⁩⁧لا الوثيقة كلها دفعة واحدة⁩⁧تحقّق وفق قائمة الاكتمال⁩⁧العبارات التي كتبتها أولًا⁩⁧أمنية مع طلب واسع⁩⁧دون وصف المتطلبات يخمّن؛ ودون⁩⁧الجزء الصغير يحاول كل شيء — وما⁩⁧يعود واسع وسطحي وصعب الإصلاح⁩⁧احفظ وصف المتطلبات في ملف تلصقه مجددًا⁩⁧المحادثات تنسى والأدوات تُعاد تشغيلها — وإعادة ذكر القيود نفسها توقف الانحراف التدريجي⁩⁧المواضع الغامضة تُملأ بالتخمين — أزل التخمين حيث سيزعجك⁩⁧وقل ماذا يحدث حين تسوء الأمور — فالمسارات غير السعيدة هي أضعف ما في البرمجيات المولَّدة⁩
⁧لمن هو، وماذا يجب أن يفعل، وما يجب ألّا يفعله أبدًا، وما يتحقق عند اكتماله — ثم الصق ذلك كله واطلب جزءًا صغيرًا واحدًا.⁩

ثلاثة أسئلة هي كل وصف المتطلبات

وصف المتطلبات (Spec) هو ببساطة وصف مكتوب لما تريد بناءه. لا تحتاج إلى مستند تقني. تحتاج إلى إجابات عن ثلاثة أسئلة، مكتوبة بجمل عادية. لمن هذا؟ ليس «للجميع»، بل لشخص محدد: ما الذي يعرفه مسبقًا، وعلى أي جهاز يعمل، وكم لديه من الصبر. ما الذي يجب أن يفعله؟ الأفعال التي يستطيع الشخص القيام بها، مكتوبة بوضوح، بالترتيب الذي تحدث به. ما الذي يجب ألا يفعله أبدًا؟ الحدود، وهو القسم الذي يتخطاه الناس ثم يندمون. هذا السؤال الثالث هو الأثمن، لأن الذكاء الاصطناعي (AI) لن يخترع القيود نيابةً عنك. إذا لم تقل أبدًا إن الزوار يجب ألا يروا مُدخلات بعضهم بعضًا، فلا شيء في طلبك يوحي بذلك. ستحصل على ما طلبته بالضبط، لا على ما افترضته.

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

كن محددًا حيث يهمّ ذلك

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

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

قل كيف يبدو النجاح

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

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

أعطِ الذكاء الاصطناعي وصفًا للمتطلبات، لا أمنية

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

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

جرّب بنفسك

في نهاية الوحدة الأولى قلّصت فكرتك إلى نسخة تُنجز في عطلة نهاية أسبوع. والآن اكتب وصف المتطلبات لتلك النسخة — المستند الذي ستلصقه في كل جلسة بناء من الآن فصاعدًا.

◆ جرّبها بنفسك

املأ القالب أدناه لنسخة عطلة نهاية الأسبوع بجمل عادية، واحفظه في ملف تستطيع لصقه مجددًا لاحقًا. اقضِ أطول وقت في القسم الأخير.

ما هو: [جملة أو جملتان بسيطتان]

من يستخدمه: [شخص واحد محدد — ما الذي يعرفه، وعلى أي جهاز يعمل]

الشاشات: [كل شاشة من الأعلى إلى الأسفل، وكل زر أو عنصر تحكم، وماذا يحدث عند الضغط عليه]

ماذا يحدث حين تسوء الأمور: [حقول فارغة، قيم خاطئة، الضغط على الزر مرتين]

ما الذي يجب ألا يفعله أبدًا: [الحدود — من يجب ألا يرى ماذا، وما الذي يجب ألا يحدث أبدًا دون علمي]
كيف تعرف أنها نجحت
  • يستطيع شخص لم يسمع بفكرتك من قبل أن يبني نسخة تقريبية منها اعتمادًا على وصف المتطلبات وحده
  • قسم «ما يجب ألا يفعله أبدًا» يحتوي على سطرين على الأقل
  • وصف المتطلبات محفوظ في ملف تستطيع لصقه مجددًا، لا في نافذة محادثة فقط