بناء أمر قابل للفحص

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

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

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

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

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