اكتب وصف مهمة لوكيل

صف تغييراً يستطيع المراجع تقييمه

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

ابدأ بالمستخدم والمشكلة. ثم صف السلوك المطلوب. أدرج الأدلة التي ستبيّن إن كانت النتيجة مقبولة.

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

استخدم مثالاً محدداً

وصف المهمة التالي لتطبيق دعم خيالي. وهو مثال تعليمي، وليس مواصفات كاملة للإنتاج.

النتيجة: يستطيع مدير دعم تنزيل قائمة عملاء.
من ينفّذ الفعل: مدير في المؤسسة الحالية.
البيانات: بيانات العملاء النشطين في تلك المؤسسة فقط.
الحقول: معرّف العميل واسم الشركة وحالة الحساب.
التنسيق: CSV بترميز UTF-8 مع صف عناوين.
طلب مرفوض: إعادة خطأ التخويل الموجود.
نتيجة فارغة: إعادة ملف CSV صالح لا يحتوي إلا على العناوين.
النطاق: استخدام مسار التصدير ونمط التدقيق الموجودين.
خارج النطاق: لا أدوار جديدة ولا تبعيات ولا نشر.
الأدلة: اختبارات للطلبات المسموح بها والمرفوضة والفارغة والتي تعبر حدود المؤسسة.

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

افصل المتطلبات عن الافتراضات

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

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

قد يتعارض قيد أيضاً مع النتيجة. فقد يعيد المسار الموجود بيانات كل المؤسسات بحكم تصميمه. يجب أن يوضّح الوكيل التعارض ويقترح تصحيحاً محدوداً. ويجب ألا يحذف حد البيانات بصمت أو يوسّع المهمة إلى إعادة كتابة المعمارية.

اجعل الأدلة جزءاً من الإكمال

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

يجب أن يحتفظ طلب الدمج بسبب التغيير. فقد يرى مسؤول صيانة لاحق الشيفرة دون المحادثة الأصلية. أدرج سياقاً كافياً لشرح سبب استبعاد حقول معينة من التصدير وكيف تُطبّق ضوابط الوصول.

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

اجعل التفاصيل متناسبة مع المهمة

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

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