مواصفات الـ Output — وحيلة الـ format-lock

لو هتتعلم خانة واحدة بس كويس، خليها دي. مواصفات الـ output هي الفرق بين output تقدر تلصقه على طول في Slack وoutput تضطر تعيد تنسيقه بإيدك 10 دقايق.

مواصفات الـ Output بتغطّي إيه

الخانة الفرعية	أمثلة قيم
الطول	"أقل من 80 كلمة"، "3 جمل بالظبط"، "5 نقاط"
الصيغة	"JSON object"، "جدول markdown"، "قايمة مرقّمة"، "نص متصل"
النبرة	"ودودة ومهنية"، "حادة"، "أكاديمية"
المتضمَّنات	"ضيف تاريخ الموعد"، "اختم دايماً بتوقيع"
المستبعَدات	"من غير مقدمة"، "ما تستخدمش كلمة 'للأسف'"، "من غير سور markdown"

أغلب prompts الـ beginners بتتخطى تلاتة أو أربعة من دول. عشان كده الموديل بيقرر بدالك وإنت بتقضي وقت في التعديل بعدين.

حيلة الـ format-lock

ساعات مش بس عايز نبرة معينة — محتاج شكل محدد يقدر الكمبيوتر يقراه. JSON صرف لـ API. عدد محدد من النقط. جدول بأعمدة متسماة. للحالات دي، تستخدم format-lock: تعليمة صريحة آلية بتثبّت الشكل بالظبط.

دي مثال حقيقي. سألنا الموديل:

Extract the structured data from this sentence and return ONLY a JSON object
with keys: name, age, city. No prose, no markdown fence.

"Hi, I'm Mariam, 29, and I just moved to Cairo from Alexandria."

الـ output الملتقَط:

```json
{
  "name": "Mariam",
  "age": 29,
  "city": "Cairo"
}
```

لقطة من Claude Sonnet 4.5 (claude-sonnet-4-5) في 2026-04-27. الـ re-runs ممكن تختلف شوية.

النتيجة هي JSON بالظبط اللي طلبناه — بس Claude لفّه في سور markdown رغم تعليمة "من غير سور markdown" الصريحة. ده فشل حقيقي شايع للـ format-lock. بيعلّم درسين:

1. القيود بتساعد بس مش سحر. حتى prompt محكم ومحدد كويس ممكن ينتج انحراف صغير. الـ format-lock ضبط الـ محتوى والـ بنية؛ سور الـ markdown غلاف الموديل ضافه فوق.
2. حط خطوة تنظيف صغيرة في الكود. لما بتنادي LLM لـ output مهيكل، شغّل دايماً cleaner من سطر واحد بيشيل علامات ```json و ``` قبل الـ parse. دي ممارسة قياسية وبتوفر إعادة تشغيل الـ prompt.

قايمة فحص مواصفات الـ Output

مواصفات output قوية بتجاوب على الـ5 التاليين:

1. الطول قد إيه؟
2. الصيغة إيه؟
3. النبرة إيه؟
4. إيه اللي لازم يظهر؟
5. إيه اللي لازم ما يظهرش؟

لو قدرت تجاوب على الـ5 قبل الإرسال، الـ output اللي هيوصلك هيحتاج تعديل بسيط.

نسخة مكتملة

دي مواصفات output كاملة لمهمة رد على عميل:

Output:
- Plain prose, no markdown.
- Exactly 4 short paragraphs.
- Tone: warm, direct, no corporate fluff.
- Must acknowledge the specific issue in the first sentence.
- Must end with "— Bayt Coffee team" on its own line.
- Must not contain the words "unfortunately", "as per", "kindly".

دول 7 قيود صريحة في 7 أسطر. الشكل اللي هيوصلك متحدد قبل ما الموديل حتى يبدأ يكتب.

التالي: مثال محلول بيستخدم الـ5 خانات مع بعض — الدور، المهمة، الـ context، الـ input، ومواصفات الـ output. :::