هندسة الأوامر بالعربية: كيف تكتب تعليمة تعطي نتيجة ثابتة

بنية الأمر الفعال

1. الدور والسياق — لمن تكتب وفي أي مجال، فتضبط المصطلحات ومستوى التفصيل.
2. المهمة — فعل واحد واضح: لخص، أو صنف، أو استخرج، أو أعد صياغة.
3. المدخل — مفصول بعلامة واضحة عن التعليمة حتى لا يختلط النص بالأمر.
4. شكل المخرج — عدد النقاط، وطول الفقرة، والحقول المطلوبة، ولغة الإخراج.
5. القيود — ما يمنع: التخمين، وإضافة معلومات من خارج النص، وتغيير المصطلحات.

حدد المخرج كأنك تصف حقلا في قاعدة بيانات

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

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

الأمثلة أقوى من الشرح

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

خصوصية العربية

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

أخطاء شائعة

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

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

أسئلة شائعة

هل تختلف الأوامر بين النماذج؟

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

هل الأمر الطويل أفضل؟

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

كيف نمنع تسرب التعليمات عبر مدخلات المستخدم؟

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