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

اكتب أولًا كيف يبدو «الجيد»

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

من خمس إلى عشر جمل

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

  • من خمس إلى عشر جمل بسيطة، كل منها يمكن التحقق منه يدويًا في دقيقة
  • غطِّ الإجراء الأساسي، والحدود، والمدخلات الخاطئة الواضحة
  • هذه القائمة هي معنى «يعمل»؛ وكل ما عداها تفضيلات
  • احفظها في ملف واحد بجانب وصف المتطلبات (Spec)، لا متناثرة في سجل المحادثة

لماذا «قبل» مهمة

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

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

أضِف بنود «أبدًا»

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

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

اجعلها قصيرة بما يكفي لتُستخدم

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

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

جرّب بنفسك

قرأت للتو لماذا يجب أن تأتي القائمة قبل البناء. فتوقّف هنا واكتب قائمتك — للمشروع الذي تبنيه فعلًا — قبل أن تغيّر أي شيء آخر.

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

املأ القالب أدناه لمشروعك، بحيث يمكن التحقق من كل بند يدويًا في أقل من دقيقة. ثم شغّل القائمة مرة واحدة، اليوم، وانظر ما الذي يفشل.

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

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