اختيار المشكلة

طريقان إلى نفس الفكرة

قبل أن تبدأ

الفكرة الجوهرية

قبل أي سطر كود تكتب أربعة أشياء بالترتيب: من المستخدم، وما معيار النجاح، وما خط الأساس الذي تتجاوزه، وما الذي لن تبنيه.

1المستخدم: شخص باسمه

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

انظر إلى الرسم: نورة صاحبة متجر تقرأ رسائل الدعم بيدها، و40% منها سؤال واحد يتكرّر.

هذه مشكلة تعيشها كل أسبوع، ولها رقم تقيسه: الوقت الذي يضيع. هذا ما يجعلها مشكلة تستحق أسابيع من العمل.

2معيار النجاح قبل الكود

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

انظر إلى الرسم: تغطية 50% بدقة 95% على فئة الشحن.

الترجمة تكشف ما لم تفكّر فيه: هنا الدقة أهم من التغطية، لأن ردًّا خاطئًا على عميل أسوأ من عدم الرد.

وتقيسه على مئة حالة حقيقية على الأقل من الشهر الماضي، يصنّفها المستخدم بنفسه، ثم تجمّدها قبل أن تبني.

3خط الأساس الذي تتجاوزه

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

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

from collections import Counter

# 20 real support messages from a small shop, labelled by the owner
messages = [
    ("وين طلبي؟ صار له أسبوع", "shipping"),
    ("كم سعر التوصيل للرياض؟", "shipping"),
    ("الشحنة متأخرة ومحد يرد", "shipping"),
    ("متى يوصل الطلب لجدة؟", "shipping"),
    ("رقم التتبع ما يشتغل", "shipping"),
    ("المندوب ما اتصل علي", "shipping"),
    ("هل التوصيل مجاني فوق ٢٠٠؟", "shipping"),
    ("طلبت من عشرة أيام وما وصل شي", "shipping"),
    ("أبي أرجع المنتج", "returns"),
    ("كيف أستبدل المقاس؟", "returns"),
    ("المنتج ما عجبني أبي فلوسي", "returns"),
    ("ابغى استرجاع المبلغ", "returns"),
    ("المنتج وصل مكسور", "damaged"),
    ("الكرتون مفتوح والقطعة ناقصة", "damaged"),
    ("اللون غير اللي في الصورة وفيه خدش", "damaged"),
    ("هل عندكم مقاس أكبر؟", "product"),
    ("القماش قطن ولا بوليستر؟", "product"),
    ("متى ينزل اللون الأسود؟", "product"),
    ("هل يناسب الغسالة؟", "product"),
    ("فيه ضمان على الجهاز؟", "product"),
]

labels = [label for _, label in messages]
majority, count = Counter(labels).most_common(1)[0]
print(f"majority baseline: always '{majority}' -> {count / len(labels):.0%}")

def keyword_rule(text):
    if any(w in text for w in ["طلب", "التوصيل", "الشحن", "يوصل"]):
        return "shipping"
    if any(w in text for w in ["أرجع", "استرجاع", "أستبدل"]):
        return "returns"
    if any(w in text for w in ["مكسور", "ناقصة", "خدش"]):
        return "damaged"
    return "product"

wrong = [(t, y, keyword_rule(t)) for t, y in messages if keyword_rule(t) != y]
print(f"keyword rule:      {1 - len(wrong) / len(messages):.0%}")
for text, truth, guess in wrong:
    print(f"  missed: {text}  (truth {truth}, rule said {guess})")

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

4أصغر نطاق، وما لن تبنيه

المشاريع الختامية تموت من النطاق لا من الصعوبة. اختر مهمة واحدة يجرّبها المستخدم كاملة في أسبوعين، لا خمس مهام نصف منجزة.

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

صفحة واحدة تكتبها قبل الكود وتُريها للمستخدم ليوافق عليها. هذا قالب مملوء لمثال المتجر.

# Scope: shipping replies for <shop name>

User:        Noura, owner, answers ~60 support messages a day by hand
Today:       ~2 hours a day; 40% of messages are "where is my order?"
Task:        classify incoming messages; for shipping status questions,
             draft a reply with the tracking status for Noura to send
Success bar: on 150 held-out real messages labelled by Noura:
             - shipping precision >= 95% (a wrong draft costs her trust)
             - drafts accepted without edits >= 60%
             - beats the keyword rule (85% on the dev messages) on new data
Baseline:    keyword rule, written and measured first
Data:        last month's messages, phone numbers and emails removed
             before they leave Noura's laptop
Not building: login, other message channels, returns, refunds,
             automatic sending without Noura's click, an app
Deadline:    first usable version in 2 weeks, stranger test in week 4

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

كيف يعمل، خطوة بخطوة: كيف تكتب وثيقة النطاق قبل الكود

أعمق قليلًا

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

مثال محلول

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

١. كم مثالًا يكفي؟

import math

def wilson(correct, n, z=1.96):
    p = correct / n
    centre = (p + z * z / (2 * n)) / (1 + z * z / n)
    half = z * math.sqrt(p * (1 - p) / n + z * z / (4 * n * n)) / (1 + z * z / n)
    return centre - half, centre + half

# the same 80% accuracy, measured on eval sets of different sizes
for n in [20, 50, 100, 300, 1000]:
    low, high = wilson(round(0.8 * n), n)
    print(f"n={n:5}: 80% means somewhere in {low:.0%} .. {high:.0%}  (width {high - low:.0%})")

على عشرين مثالًا، 80% تعني أي شيء بين 58% و92%، أي أن نظامًا ضعيفًا ونظامًا ممتازًا قد يعطيان نفس الرقم. على مئة مثال يضيق المدى إلى 16 نقطة، وعلى ثلاثمئة إلى 9. القاعدة العملية للمشروع الختامي: مئة مثال على الأقل في مجموعة التقييم، وثلاثمئة إن أردت أن تفرّق بين نسختين متقاربتين.

جرّب بلا كود

خرافة مقابل حقيقة

جرّب بنفسك

بطاقات مراجعة سريعة

تحقق من فهمك