بعيداً عن الهيكلة، تسترشد هندسة المطالبات الفعّالة بمبادئ أساسية—حقائق جوهرية تنطبق على جميع النماذج والمهام والسياقات. أتقن هذه المبادئ، وستتمكن من التكيف مع أي تحدٍّ في كتابة المطالبات.

<Callout type="info" title="المبادئ الثمانية الأساسية">
تنطبق هذه المبادئ على كل نموذج ذكاء اصطناعي وكل مهمة. تعلّمها مرة واحدة، واستخدمها في كل مكان.
</Callout>

## المبدأ الأول: الوضوح قبل الذكاء

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

### كن صريحاً

<Compare 
  before={{ label: "ضمني (إشكالي)", content: "اجعل هذا أفضل." }}
  after={{ label: "صريح (فعّال)", content: "حسّن هذا البريد الإلكتروني من خلال:\n1. جعل سطر الموضوع أكثر جاذبية\n2. تقصير الفقرات إلى 2-3 جمل كحد أقصى\n3. إضافة دعوة واضحة لاتخاذ إجراء في النهاية" }}
/>

### تجنب الغموض

يمكن أن يكون للكلمات معانٍ متعددة. اختر لغة دقيقة.

<Compare 
  before={{ label: "غامض", content: "أعطني ملخصاً قصيراً.\n(كم قصيراً؟ جملة واحدة؟ فقرة واحدة؟ صفحة واحدة؟)" }}
  after={{ label: "دقيق", content: "لخّص في 3 نقاط بالضبط، كل نقطة أقل من 20 كلمة." }}
/>

### اذكر ما هو واضح

ما هو واضح لك ليس واضحاً للنموذج. وضّح الافتراضات.

```
أنت تساعدني في كتابة خطاب تقديمي.

سياق مهم:
- أتقدم لوظيفة مهندس برمجيات في Google
- لدي 5 سنوات من الخبرة في Python والأنظمة الموزعة
- تتطلب الوظيفة خبرة قيادية (قدت فريقاً من 4 أشخاص)
- أريد التأكيد على مساهماتي في المصادر المفتوحة
```

## المبدأ الثاني: الدقة تؤدي إلى الجودة

المدخلات الغامضة تنتج مخرجات غامضة. المدخلات المحددة تنتج مخرجات محددة ومفيدة.

### سلّم الدقة

<SpecificitySpectrum levels={[
  { level: "المستوى 1", text: "اكتب عن تغير المناخ" },
  { level: "المستوى 2", text: "اكتب مقالاً عن آثار تغير المناخ" },
  { level: "المستوى 3", text: "اكتب مقالاً من 500 كلمة عن كيفية تأثير تغير المناخ على الشعاب المرجانية" },
  { level: "المستوى 4", text: "اكتب مقالاً من 500 كلمة يشرح كيف يتسبب ارتفاع درجة حرارة المحيطات في ابيضاض المرجان، موجهاً لطلاب المرحلة الثانوية، مع مثالين محددين من الحاجز المرجاني العظيم، بأسلوب جذاب ولكن دقيق علمياً" }
]} />

كل مستوى يضيف دقة ويحسّن جودة المخرجات بشكل كبير.

### حدد هذه العناصر

<div className="my-4 grid gap-2">
  <div className="flex gap-2 p-3 bg-muted/50 rounded-lg">
    <span className="font-semibold min-w-24">الجمهور</span>
    <span className="text-muted-foreground">من سيقرأ/يستخدم هذا؟</span>
  </div>
  <div className="flex gap-2 p-3 bg-muted/50 rounded-lg">
    <span className="font-semibold min-w-24">الطول</span>
    <span className="text-muted-foreground">كم يجب أن يكون طويلاً/قصيراً؟</span>
  </div>
  <div className="flex gap-2 p-3 bg-muted/50 rounded-lg">
    <span className="font-semibold min-w-24">النبرة</span>
    <span className="text-muted-foreground">رسمية؟ غير رسمية؟ تقنية؟</span>
  </div>
  <div className="flex gap-2 p-3 bg-muted/50 rounded-lg">
    <span className="font-semibold min-w-24">التنسيق</span>
    <span className="text-muted-foreground">نص؟ قائمة؟ جدول؟ كود؟</span>
  </div>
  <div className="flex gap-2 p-3 bg-muted/50 rounded-lg">
    <span className="font-semibold min-w-24">النطاق</span>
    <span className="text-muted-foreground">ماذا يجب تضمينه/استبعاده؟</span>
  </div>
  <div className="flex gap-2 p-3 bg-muted/50 rounded-lg">
    <span className="font-semibold min-w-24">الغرض</span>
    <span className="text-muted-foreground">ماذا يجب أن يحقق هذا؟</span>
  </div>
</div>

## المبدأ الثالث: السياق هو الملك

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

### قدم سياقاً كافياً

<Compare 
  before={{ label: "سياق غير كافٍ", content: "لماذا لا تعمل دالتي؟" }}
  after={{ label: "سياق كافٍ", content: "لدي دالة Python يجب أن تفلتر قائمة من القواميس حسب قيمة مفتاح محدد. إنها تعيد قائمة فارغة بينما يجب أن تعيد 3 عناصر.\n\nالدالة:\ndef filter_items(items, key, value):\n    return [item for item in items if item[key] = value]\n\nالاستدعاء: filter_items(items, 'status', 'active')\nالمتوقع: عنصران، النتيجة: قائمة فارغة" }}
/>

### قائمة التحقق من السياق

<Callout type="tip" title="قبل الإرسال">
اسأل نفسك: هل سيفهم شخص غريب ذكي هذا الطلب؟ إذا لم يكن كذلك، أضف المزيد من السياق.
</Callout>

<Checklist 
  title="قائمة التحقق من السياق"
  items={[
    { text: "هل يعرف النموذج ما أعمل عليه؟" },
    { text: "هل يعرف هدفي؟" },
    { text: "هل لديه جميع المعلومات الضرورية؟" },
    { text: "هل يفهم القيود؟" },
    { text: "هل سيفهم شخص غريب ذكي هذا الطلب؟" }
  ]}
/>

## المبدأ الرابع: وجّه، لا تسأل فقط

لا تطلب إجابة فحسب—وجّه النموذج نحو الإجابة التي تريدها.

### استخدم الإطار التوجيهي

<Compare 
  before={{ label: "مجرد سؤال", content: "ما هي إيجابيات وسلبيات الخدمات المصغرة؟" }}
  after={{ label: "توجيه", content: "اذكر 5 مزايا و5 عيوب لهندسة الخدمات المصغرة.\n\nلكل نقطة:\n- اذكر النقطة بوضوح في جملة واحدة\n- قدم شرحاً موجزاً (2-3 جمل)\n- أعطِ مثالاً ملموساً\n\nضع في الاعتبار وجهات نظر: الشركات الناشئة الصغيرة، والمؤسسات الكبيرة، والفرق المنتقلة من التطبيقات المتجانسة." }}
/>

### قدم سقالات للتفكير

للمهام المعقدة، وجّه عملية التفكير:

<TryIt 
  title="مثال على سقالات التفكير"
  description="هذه المطالبة توجه الذكاء الاصطناعي عبر عملية اتخاذ قرار منهجية."
  prompt={`أحتاج للاختيار بين PostgreSQL وMongoDB لمشروع التجارة الإلكترونية الخاص بي.

فكّر في هذا بشكل منهجي:
1. أولاً، اذكر المتطلبات النموذجية لقاعدة بيانات التجارة الإلكترونية
2. ثم، قيّم كل قاعدة بيانات مقابل كل متطلب
3. ضع في الاعتبار المفاضلات الخاصة بحالة استخدامي
4. قدم توصية مع تبرير واضح`}
/>

## المبدأ الخامس: كرر وحسّن

هندسة المطالبات عملية تكرارية. مطالبتك الأولى نادراً ما تكون الأفضل.

### دورة التكرار

```
1. اكتب المطالبة الأولية
2. راجع المخرجات
3. حدد الثغرات أو المشكلات
4. حسّن المطالبة
5. كرر حتى الرضا
```

### التحسينات الشائعة

<div className="my-4 grid gap-2">
  <div className="flex gap-2 p-3 bg-muted/50 rounded-lg">
    <span className="font-semibold min-w-32">مطوّل جداً</span>
    <span className="text-muted-foreground">أضف "كن موجزاً" أو حدود للطول</span>
  </div>
  <div className="flex gap-2 p-3 bg-muted/50 rounded-lg">
    <span className="font-semibold min-w-32">غامض جداً</span>
    <span className="text-muted-foreground">أضف أمثلة محددة أو قيود</span>
  </div>
  <div className="flex gap-2 p-3 bg-muted/50 rounded-lg">
    <span className="font-semibold min-w-32">تنسيق خاطئ</span>
    <span className="text-muted-foreground">حدد هيكل المخرجات بالضبط</span>
  </div>
  <div className="flex gap-2 p-3 bg-muted/50 rounded-lg">
    <span className="font-semibold min-w-32">جوانب مفقودة</span>
    <span className="text-muted-foreground">أضف "تأكد من تضمين..."</span>
  </div>
  <div className="flex gap-2 p-3 bg-muted/50 rounded-lg">
    <span className="font-semibold min-w-32">نبرة خاطئة</span>
    <span className="text-muted-foreground">حدد الجمهور والأسلوب</span>
  </div>
  <div className="flex gap-2 p-3 bg-muted/50 rounded-lg">
    <span className="font-semibold min-w-32">غير دقيق</span>
    <span className="text-muted-foreground">اطلب الاستشهادات أو التفكير خطوة بخطوة</span>
  </div>
</div>

### احتفظ بسجل للمطالبات

وثّق ما يعمل:
```
المهمة: مراجعة الكود
الإصدار 1: "راجع هذا الكود" → عام جداً
الإصدار 2: إضافة معايير مراجعة محددة → أفضل
الإصدار 3: إضافة مثال على مراجعة جيدة → ممتاز
النهائي: [احفظ المطالبة الناجحة كقالب]
```

## المبدأ السادس: استفد من نقاط قوة النموذج

اعمل مع طريقة تدريب النماذج، وليس ضدها.

### النماذج تريد أن تكون مفيدة

صغ الطلبات كأشياء سيفعلها مساعد مفيد بشكل طبيعي:

<Compare 
  before={{ label: "ضد التيار", content: "أعلم أنك لا تستطيع فعل هذا، لكن حاول..." }}
  after={{ label: "مع التيار", content: "ساعدني في فهم...\nأعمل على X وأحتاج مساعدة في...\nهل يمكنك إرشادي خلال..." }}
/>

### النماذج تتفوق في الأنماط

إذا كنت بحاجة لمخرجات متسقة، أظهر النمط:

<TryIt 
  title="مثال على النمط"
  description="هذه المطالبة تُظهر للذكاء الاصطناعي بالضبط التنسيق الذي تريده لتوصيات الكتب."
  prompt={`أوصِ بـ 3 كتب خيال علمي. نسّق كل توصية كالتالي:

📚 **[العنوان]** بقلم [المؤلف]
*[النوع] | [سنة النشر]*
[وصف من جملتين]
لماذا ستحبه: [جملة جذابة واحدة]

---`}
/>

### النماذج يمكنها لعب الأدوار

استخدم الشخصيات للوصول إلى "أوضاع" استجابة مختلفة:

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

## المبدأ السابع: تحكم في هيكل المخرجات

المخرجات المهيكلة أكثر فائدة من النص الحر.

### اطلب تنسيقات محددة

```
أعد تحليلك كالتالي:

الملخص: [جملة واحدة]

النتائج الرئيسية:
• [النتيجة 1]
• [النتيجة 2]
• [النتيجة 3]

التوصية: [1-2 جملة]

الثقة: [منخفضة/متوسطة/عالية] لأن [السبب]
```

### استخدم الفواصل

افصل أقسام مطالبتك بوضوح:

```
### السياق ###
[سياقك هنا]

### المهمة ###
[مهمتك هنا]

### التنسيق ###
[التنسيق المطلوب هنا]
```

### اطلب مخرجات قابلة للقراءة الآلية

للاستخدام البرمجي:

```
أعد JSON صالح فقط، بدون شرح:
{
  "decision": "approve" | "reject" | "review",
  "confidence": 0.0-1.0,
  "reasons": ["مصفوفة نصية"]
}
```

## المبدأ الثامن: تحقق وتأكد

لا تثق بشكل أعمى في مخرجات النموذج، خاصة للمهام المهمة.

### اطلب التفكير

```
حل هذه المشكلة وأظهر عملك خطوة بخطوة.
بعد الحل، تحقق من إجابتك عن طريق [طريقة التحقق].
```

### اطلب وجهات نظر متعددة

```
أعطني ثلاث طرق مختلفة لحل هذه المشكلة.
لكل طريقة، اشرح المفاضلات.
```

### أدرج التحقق الذاتي

```
بعد إنشاء الكود، راجعه بحثاً عن:
- أخطاء في الصياغة
- الحالات الحدية
- الثغرات الأمنية
اذكر أي مشكلات وجدتها.
```

## الملخص: المبادئ في لمحة

<PrinciplesSummary />

<Quiz 
  question="أي مبدأ يقترح أن تضمّن جميع المعلومات الخلفية ذات الصلة في مطالبتك؟"
  options={[
    "الوضوح قبل الذكاء",
    "الدقة تؤدي إلى الجودة",
    "السياق هو الملك",
    "كرر وحسّن"
  ]}
  correctIndex={2}
  explanation="يؤكد مبدأ 'السياق هو الملك' أن نماذج الذكاء الاصطناعي ليس لديها ذاكرة بين الجلسات ولا يمكنها قراءة أفكارك. تضمين الخلفية والقيود والأهداف ذات الصلة يساعد النموذج على فهم احتياجاتك."
/>

## التمرين: املأ الفراغات

اختبر فهمك للمبادئ الأساسية من خلال إكمال قالب المطالبة هذا:

<FillInTheBlank
  title="طبّق المبادئ"
  description="املأ الفراغات لإنشاء مطالبة جيدة الهيكلة — اكتب ما تريد!"
  useAI={true}
  openEnded={true}
  template={`أنت {{role}} ذو خبرة في {{expertise}}.

السياق: أعمل على {{context}}.

المهمة: {{task}}

القيود:
- اجعل ردك أقل من {{length}} كلمة
- ركز فقط على {{focus}}

التنسيق: أعد إجابتك كـ {{format}}.`}
  blanks={[
    { id: "role", correctAnswers: [], hint: "ما الدور المهني الذي يجب أن يتقمصه الذكاء الاصطناعي؟", context: "مسمى وظيفي أو دور مهني" },
    { id: "expertise", correctAnswers: [], hint: "ما المعرفة التخصصية المطلوبة؟", context: "مهارة أو مجال يتناسب مع الدور" },
    { id: "context", correctAnswers: [], hint: "ما هو المشروع أو الموقف؟", context: "مشروع يعمل عليه شخص بهذه الخبرة" },
    { id: "task", correctAnswers: [], hint: "ما الإجراء المحدد الذي يجب أن يتخذه الذكاء الاصطناعي؟", context: "إجراء مناسب للدور والسياق" },
    { id: "length", correctAnswers: [], hint: "كم يجب أن يكون طول الرد؟", context: "رقم (عدد الكلمات)" },
    { id: "focus", correctAnswers: [], hint: "ما الجانب الذي يجب إعطاؤه الأولوية؟", context: "جودة أو جانب متعلق بالمهمة" },
    { id: "format", correctAnswers: [], hint: "كيف يجب هيكلة المخرجات؟", context: "نوع تنسيق المخرجات" }
  ]}
  explanation="المطالبة جيدة الهيكلة تتضمن: دوراً واضحاً (المبدأ 1)، سياقاً كافياً (المبدأ 3)، مهمة محددة (المبدأ 2)، قيوداً (المبدأ 4)، وتنسيق المخرجات (المبدأ 5). يتحقق الذكاء الاصطناعي مما إذا كانت اختياراتك متسقة داخلياً."
/>

<InteractiveChecklist
  title="قائمة التحقق من المبادئ"
  items={[
    { id: "clarity", label: "الوضوح قبل الذكاء", description: "هل مطالبتك صريحة وغير غامضة؟" },
    { id: "specificity", label: "الدقة تؤدي إلى الجودة", description: "هل ضمّنت الجمهور والطول والنبرة والتنسيق؟" },
    { id: "context", label: "السياق هو الملك", description: "هل تتضمن المطالبة جميع المعلومات الخلفية الضرورية؟" },
    { id: "examples", label: "الأمثلة تتفوق على الشرح", description: "هل أظهرت ما تريد، وليس فقط وصفته؟" },
    { id: "constraints", label: "القيود تركز المخرجات", description: "هل هناك حدود واضحة للنطاق والتنسيق؟" },
    { id: "iteration", label: "كرر وحسّن", description: "هل أنت مستعد للتحسين بناءً على النتائج؟" },
    { id: "persona", label: "الشخصية تشكل المنظور", description: "هل يعرف الذكاء الاصطناعي الدور الذي يجب أن يلعبه؟" },
    { id: "verify", label: "تحقق وتأكد", description: "هل أدرجت فحوصات للدقة؟" }
  ]}
/>

تشكل هذه المبادئ الأساس لكل ما يأتي لاحقاً. في الجزء الثاني، سنطبقها على تقنيات محددة تعزز فعالية المطالبات بشكل كبير.
