تشريح الأمر الفعال

كل موجه رائع يشترك في عناصر هيكلية مشتركة. فهم هذه المكونات يتيح لك بناء الموجهات بشكل منهجي بدلاً من التجربة والخطأ.

المكونات الأساسية

عادةً ما يتضمن الموجه الفعال بعض أو كل هذه العناصر:

دعنا نفحص كل مكون بالتفصيل.

1. الدور / الشخصية

تحديد دور يركز استجابات النموذج من خلال عدسة خبرة أو منظور معين.

اشرح الحوسبة الكمية.

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

الدور يهيئ النموذج لـ:

• استخدام المفردات المناسبة
• تطبيق الخبرة ذات الصلة
• الحفاظ على منظور متسق
• مراعاة الجمهور بشكل مناسب

أنماط الأدوار الفعالة

"أنت [مهنة] لديك [X سنوات] من الخبرة في [التخصص]"
"تصرف كـ [دور] يتميز بـ [خاصية]"
"أنت خبير [مجال] يساعد [نوع الجمهور]"

2. السياق / الخلفية

السياق يوفر المعلومات التي يحتاجها النموذج لفهم موقفك. تذكر: النموذج لا يعرف شيئاً عنك أو عن مشروعك أو أهدافك إلا إذا أخبرته.

أصلح هذا الخطأ في كودي.

أقوم ببناء REST API بـ Node.js باستخدام Express.js. الـ API يتعامل مع مصادقة المستخدمين باستخدام JWT tokens. عندما يحاول المستخدم الوصول إلى مسار محمي، يحصل على خطأ 403 حتى مع token صالح. إليك الكود ذو الصلة: [الكود]

ما يجب تضمينه في السياق

• تفاصيل المشروع — مجموعة التقنيات، البنية، القيود
• الحالة الحالية — ما جربته، ما يعمل، ما لا يعمل
• الأهداف — ما تحاول تحقيقه في النهاية
• القيود — حدود الوقت، المتطلبات التقنية، دليل الأسلوب

3. المهمة / التعليمات

المهمة هي قلب موجهك — ما تريد أن يفعله النموذج. كن محدداً وواضحاً.

طيف التحديد

أفعال العمل التي تعمل بشكل جيد

4. القيود / القواعد

القيود تحدد مخرجات النموذج. تمنع المشاكل الشائعة وتضمن الملاءمة.

أنواع القيود

قيود الطول:

"اجعل ردك أقل من 200 كلمة"
"قدم 5 اقتراحات بالضبط"
"اكتب 3-4 فقرات"

قيود المحتوى:

"لا تضمن أي أمثلة كود"
"ركز فقط على الجوانب التقنية"
"تجنب اللغة التسويقية"

قيود الأسلوب:

"استخدم نبرة رسمية أكاديمية"
"اكتب كما لو كنت تتحدث لطفل في العاشرة"
"كن مباشراً وتجنب لغة التحفظ"

قيود النطاق:

"اعتبر فقط الخيارات المتاحة في Python 3.10+"
"اقتصر الاقتراحات على الأدوات المجانية"
"ركز على الحلول التي لا تتطلب تبعيات إضافية"

5. تنسيق المخرجات

تحديد تنسيق المخرجات يضمن حصولك على ردود بهيكل قابل للاستخدام.

التنسيقات الشائعة

القوائم:

"أعد النتيجة كقائمة نقطية"
"قدم قائمة مرقمة من الخطوات"

البيانات المنظمة:

"أعد النتيجة بصيغة JSON مع المفاتيح: title, description, priority"
"نسّق كجدول markdown بأعمدة: الميزة، الإيجابيات، السلبيات"

هياكل محددة:

"نظّم ردك كالتالي:
 ## الملخص
 ## النقاط الرئيسية
 ## التوصيات"

مثال مخرجات JSON

حلل هذه المراجعة من العميل وأعد JSON:
{
  "sentiment": "positive" | "negative" | "neutral",
  "topics": ["مصفوفة من المواضيع الرئيسية"],
  "rating_prediction": 1-5,
  "key_phrases": ["عبارات بارزة"]
}

المراجعة: "وصل المنتج بسرعة ويعمل بشكل رائع، لكن 
التعليمات كانت مربكة."

6. الأمثلة (التعلم بالعينات القليلة)

الأمثلة هي أقوى طريقة لإظهار النموذج ما تريده بالضبط.

مثال بعينة واحدة

حوّل هذه الجمل إلى الزمن الماضي.

مثال:
الإدخال: "هي تمشي إلى المتجر"
المخرج: "هي مشت إلى المتجر"

الآن حوّل:
الإدخال: "هم يركضون كل صباح"

مثال بعينات قليلة

صنّف تذاكر الدعم هذه حسب الإلحاح.

أمثلة:
"حسابي تم اختراقه" ← حرج
"كيف أغير كلمة المرور؟" ← منخفض
"فشل الدفع لكن تم خصم المبلغ" ← عالي

صنّف: "التطبيق يتعطل عندما أفتح الإعدادات"

تجميع كل شيء معاً

إليك موجه كامل يستخدم جميع المكونات:

# الدور
أنت كاتب تقني أول لديك 10 سنوات من الخبرة في إنشاء وثائق المطورين.

# السياق
أقوم بتوثيق REST API لخدمة معالجة المدفوعات. الجمهور هم مطورون يدمجون API الخاص بنا في تطبيقاتهم. لديهم معرفة برمجية متوسطة لكن قد يكونون جدداً على مفاهيم معالجة المدفوعات.

# المهمة
اكتب توثيقاً لنقطة النهاية API التالية التي تنشئ نية دفع جديدة.

# القيود
- استخدم لغة واضحة ومختصرة
- ضمّن سيناريوهات الأخطاء الشائعة
- لا تضمن تفاصيل تنفيذ الواجهة الخلفية
- افترض أن القراء يفهمون أساسيات HTTP و JSON

# تنسيق المخرجات
نظّم التوثيق كالتالي:
1. نظرة عامة على نقطة النهاية (2-3 جمل)
2. الطلب (الطريقة، URL، الترويسات، الجسم مع مثال)
3. الاستجابة (أمثلة نجاح وخطأ)
4. مثال كود (بـ JavaScript/Node.js)

# تفاصيل نقطة النهاية
POST /v1/payments/intents
Body: { "amount": 1000, "currency": "usd", "description": "Order #1234" }

الموجه الفعال الأدنى

ليس كل موجه يحتاج جميع المكونات. للمهام البسيطة، قد تكفي تعليمات واضحة:

ترجم "Hello, how are you?" إلى الإسبانية.

استخدم مكونات إضافية عندما:

• تكون المهمة معقدة أو غامضة
• تحتاج تنسيقاً محدداً
• النتائج لا تطابق التوقعات
• الاتساق عبر استعلامات متعددة مهم

أنماط الموجهات الشائعة

هذه الأطر تعطيك قائمة مرجعية بسيطة لاتباعها عند كتابة الموجهات. انقر على كل خطوة لرؤية مثال.

أنت مستشار تسويق كبير مع 15 عامًا من الخبرة في علامات التجميل.

أنشئ تقويم محتوى وسائل التواصل للشهر القادم.

الخلفية: نبيع منتجات العناية بالبشرة العضوية للنساء 25-40. صوت علامتنا ودود وتعليمي.

الوضع: نطلق سيروم فيتامين سي جديد في الـ 15.

الأسلوب: غير رسمي، ودود مع الرموز التعبيرية، مع التركيز على التعليم بدلاً من البيع.

مثال منشور: "هل تعلم أن فيتامين سي هو بطل العناية بالبشرة؟ 🦸‍♀️ إليك لماذا ستشكرك بشرتك..."

أنشئ خطة محتوى أسبوعية مع 3 منشورات في الأسبوع.

الدور: أنت معلم رياضيات صبور متخصص في تسهيل المفاهيم للمبتدئين.

المهمة: اشرح ما هي الكسور وكيفية جمعها.

الصيغة:
- ابدأ بمثال من العالم الحقيقي
- استخدم لغة بسيطة (بدون مصطلحات)
- أظهر 3 مسائل للتدريب مع الحلول
- اجعلها أقل من 300 كلمة

الملخص

الموجهات الفعالة تُبنى، لا تُكتشف. من خلال فهم وتطبيق هذه المكونات الهيكلية، يمكنك:

• الحصول على نتائج أفضل من المحاولة الأولى
• تصحيح الموجهات التي لا تعمل
• إنشاء قوالب موجهات قابلة لإعادة الاستخدام
• التواصل بنواياك بوضوح

أنت مدير منتج أول لديك 10 سنوات من الخبرة في منتجات SaaS.

السياق: أقوم ببناء تطبيق إدارة مهام للفرق عن بُعد. نحن شركة ناشئة صغيرة بموارد هندسية محدودة.

المهمة: اقترح 3 ميزات يجب أن نعطيها الأولوية لـ MVP الخاص بنا.

القيود:
- يجب أن تكون الميزات قابلة للتنفيذ من فريق من مطورين اثنين في 4 أسابيع
- ركز على ما يميزنا عن Trello و Asana

التنسيق: لكل ميزة، قدم:
1. اسم الميزة
2. وصف من جملة واحدة  
3. لماذا هي مهمة للفرق عن بُعد

ابنِ موجهك الخاص

الآن دورك! استخدم منشئ الموجهات التفاعلي هذا لبناء موجهك الخاص باستخدام المكونات التي تعلمتها:

في الفصل التالي، سنستكشف المبادئ الأساسية التي توجه قرارات بناء الموجهات.