هندسة الأوامر: أربع ركائز والباقي تفاصيل

معظم ما يُسمّى هندسة أوامر هو في الحقيقة تحرير جيّد: تعرف ما تريد، وتقوله بدقّة.

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

الدور والسياق

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

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

القاعدة العملية: اكتب السياق الذي كنت ستشرحه لزميل جديد قبل أن تسلّمه المهمّة. إن كنت ستقول له «انتبه، القارئ لا يعرف Docker»، فهذا سطر يجب أن يكون في الأمر.

صيغة المخرجات

حدّد الشكل الذي تريده: جدول، قائمة، JSON. الغموض هنا يكلّفك جولة إضافية.

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

أعد النتيجة بهذه الصيغة حصراً، بلا نصّ قبلها أو بعدها:

{
  "العنوان": "…",
  "الفكرة_الرئيسية": "…",
  "النقاط": ["…", "…", "…"],
  "الجمهور": "مبتدئ | متوسّط | متقدّم"
}

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

القيود السلبية

ما لا تريده لا يقلّ أهمّية عمّا تريده. «بلا مقدّمات إنشائية» و«بلا تكرار للسؤال» و«بلا اعتذارات» تحذف ثلث المخرجات المعتادة قبل أن تبدأ التحرير.

لكن احذر الإفراط: قائمة طويلة من الممنوعات تشوّش أكثر ممّا تضبط. ثلاثة قيود دقيقة أفضل من عشرة عامّة.

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

الأمثلة القليلة

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

وإن كانت مخرجاتك تتغيّر بتغيّر المدخل، أرفق مثالاً لمدخل ناقص وكيف يجب أن تبدو الاستجابة له. هذه أكثر نقطة تُنسى.

ما بعد الركائز

بعد ضبط الأربع، الباقي ضبط دقيق: ترتيب الأقسام داخل الأمر، وموضع التعليمة الحاسمة (البداية والنهاية أقوى من الوسط)، وطول الأمثلة. هذه أمور تُقاس ولا تُفتى فيها — جرّب نسختين على نفس عشر الحالات وقارن.

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

أخطاء شائعة تُفسد أمراً جيّداً

بعد ضبط الركائز، يبقى أن نتجنّب ما يهدمها. هذه أكثر أربعة أنماط رأيناها.

• خلط التعليمة بالمحتوى في فقرة واحدة — النموذج لا يعرف أين تنتهي إحداهما
• تعليمات متناقضة تراكمت عبر تعديلات متتابعة بلا تنظيف
• مثال واحد فقط، فيُقلَّد حرفياً بدل أن يُفهم نمطه
• طلب عدّة مهامّ مختلفة في أمر واحد

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

قبل أن تضيف سطراً جديداً إلى أمر لا يعمل، احذف سطرين. الأمر المتضخّم يفشل غالباً لتناقض داخلي لا لنقص.

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