سير عمل فعال: أربعة أنماط معمارية بالتكامل مع coding agent
💡 الهدف: إتقان الأنماط المعمارية الأربعة من وثيقة Patterns الرسمية في نحو 44 دقيقة، وتجميع أول سير عمل Jev بمستوى إنتاجي لك — طلب واحد يطرح دفعة من الأسئلة، وتوجيه متدرّج حسب الثقة، ودمج مرجّح للدرجات الذرية، وأخيرًا جعل Claude Code يكتب عنك الكود الذي يستدعي Jev.
🎯 أهداف المرحلة
- تفكيك عملية أعمال إلى أحكام ذرية، ومعرفة ما تحلّه كل من الأنماط المعمارية الرسمية الأربعة وما فوائدها
- كتابة كود «يستوعب ثلاثة أنواع من الأسئلة في طلب واحد»، مع القدرة على توضيح كم هو أرخص وأسرع من سؤال واحد لكل طلب
- تركيب فرامل على الأتمتة: استخدام تقسيم confidence لتحديد ما إذا كان يجب التنفيذ التلقائي أم طلب تأكيد المستخدم أم التحويل إلى بشري
- تثبيت TypeSafe Agent Skill داخل Claude Code بحيث يولّد الـ agent كود استدعاء Jev الصحيح
⏳ الوقت المتوقع
- مجموع 4 دروس نحو 44 دقيقة، وباحتساب هامش مرونة نحو 31–57 دقيقة
- كل درس مستقل بذاته ويمكن قراءته منفردًا عند الحاجة؛ 3.1 هو أساس الدروس التالية، لذا يُنصح بالبدء به
🚀 قبل البدء
- أنجزت الاستخدام اليومي: إتقان الطرق الخمس للسؤال في Jev: معرفة كيفية طرح أنواع الأسئلة الثلاثة Choice / Score / Noul — بوابات الثقة في هذه المرحلة تعتمد كليًا على أساس درس Confidence الثقة
- التثبيت وأول طلب لا يزال يعمل:
TYPESAFE_API_KEYموجود في متغيرات البيئة - (الدرس 4 فقط يحتاج إلى ذلك) مثبَّت لديك Claude Code أو أي coding agent آخر؛ عدم وجوده لا يؤثر على الدروس الثلاثة الأولى
- كوب من الماء ☕ — هذه المرحلة تركز على بناء المعمارية، ومقدار الكود ليس كبيرًا
📚 دروس هذه المرحلة
انظر أولًا ما المشكلات التي يمكن لسير عمل Jev هذا حلّها. إذا كنت تكتب بهذه الطريقة عادةً، فهذه المرحلة مُعدّة لك:
| طريقتك الحالية | بدّلها بسير عمل Jev |
|---|---|
| ❌ التوسّل إلى الـ LLM في الـ prompt «يرجى إرجاع JSON»، ثم كتابة كومة من كود التحليل لاحتواء انحراف الصيغة | ✅ الإجابة تكون بطبيعتها ضمن الخيارات التي تعطيها، والكود يستخدم if مباشرةً، دون استرجاع القيم من نص مولَّد |
| ❌ طلب واحد لكل رسالة، فترتفع التكلفة والزمن مع ازدياد الحجم | ✅ طلب واحد يطرح N من الأسئلة بالتوازي: إضافة الأسئلة لا تكاد تزيد زمن الاستجابة، فقط tokens أسئلة إضافية قليلة |
| ❌ النموذج لا يعترف أبدًا بـ «لست متأكدًا»، فيجيب حتى وهو مخطئ، فتضطر للمراقبة البشرية طوال الوقت | ✅ confidence هو درجة اليقين المحسوبة من التوزيع الاحتمالي (0–1)، وإذا انخفضت يتم التحويل التلقائي إلى بشري |
تلخّص وثيقة Patterns الرسمية هذه الممارسات في أربعة أنماط معمارية. الدروس 3 الأولى من هذه المرحلة تشرحها واحدًا واحدًا، والدرس 4 يحل مسألة «من يكتب هذه الأكواد»:
| النمط | بجملة واحدة | الفائدة |
|---|---|---|
| التفريع التخميني Speculative fan-out | الأسئلة «التي قد تلزم» تُطرح كلها في طلب واحد، والكود يقرر لاحقًا أيها يستخدم | التكلفة، السرعة |
| التوجيه ببوابة الثقة Confidence-gated routing | الإجابة تخبرك «ما هو»، وconfidence يخبرك «هل ننفّذ» | الموثوقية، الأمان |
| التقييم المركّب Composite scoring | الأحكام المعقدة تُفكَّك إلى درجات ذرية، وتُدمج مرجّحةً في الكود | التكلفة، الموثوقية، السرعة |
| توجيه النوايا Intent routing | صنّف النية أولًا، ثم وجّهها إلى منطق حتمي أو LLM خبير أو بشري | التكلفة، السرعة |
كيف تختار؟ لا يوجد في الوثائق الرسمية قسم جاهز لـ «اختيار النمط»، وعمود الفائدة هو المرجع الأكثر عملية: إذا كانت أولويتك التكلفة والسرعة، فابدأ بالتفريع والتوجيه؛ وإذا كان همّك الخطأ والأمان، فابدأ ببوابة الثقة.
ترتيب الدروس:
| الدرس | المحتوى | المدة |
|---|---|---|
| 3.1 الأسئلة المتوازية والتفريع التخميني | اختبار رسمي لطرح 13 سؤالًا في طلب واحد: أرخص بمقدار 12.2 ضعفًا، وأسرع بمقدار 10.0 ضعفًا، والإجابات كما هي؛ الأسئلة التخمينية «تُطرح دون استخدام» تكاد تكون مجانية | 12 دقيقة |
| 3.2 التوجيه الذكي | تصنيف النية بـ Choice + تقييم التعقيد بـ Score، والتوزيع حسب confidence إلى كود حتمي أو LLM خبير أو بشري؛ العتبات تتقلص وتتمدد مع المخاطر — 0.6 للحالات الاحتياطية، والتحويل التلقائي للأموال يتطلب 0.85 | 12 دقيقة |
| 3.3 التقييم المركّب | حالة فرز السير الذاتية: 4 أبعاد يُقيَّم كل منها بـ Score، ثم تُدمج مرجّحةً بعد التطبيع؛ إذا لم يعجبك الترتيب فعدّل الأوزان، لا الـ prompt | 10 دقيقة |
| 3.4 التطوير بالتكامل مع Claude Code | Jev ليست نموذجًا لـ coding agent — ثبّت TypeSafe Agent Skill ليكتب الـ agent كودًا يستدعي Jev؛ 3 أمثلة prompt رسمية و5 أسئلة شائعة | 10 دقيقة |
💡 جرّبه الآن
Agent Skill الخاص بـ TypeSafe في الدرس 4، يمكن تثبيته بأمرين فقط داخل Claude Code:
claude plugin marketplace add typesafe-ai/skills
claude plugin install typesafe@typesafe-aiبعد التثبيت، اذكر في المحادثة «use the TypeSafe skill»، أو نادِ /typesafe:typesafe-ai مباشرة. أما بقية الـ agents (مثل Codex) فاستخدم npx skills add typesafe-ai/skills --skill typesafe-ai.
🎒 ما ستكسبه
- منهجية التصميم «فكّك أولًا إلى أحكام ذرّية، ثم اختر النمط للتجميع» — تسمّيها الجهة الرسمية المهارة الأساسية للاستفادة من TypeSafe
- سيناريوهات استخدام أنماط البنية الأربعة وموازنة مكاسبها، مع هيكل كود رسمي في كل درس يمكنك نقله كما هو
- الإحساس العملي بتصنيف الأتمتة: تنفيذ تلقائي عند الثقة العالية، طلب تأكيد عند الثقة المتوسطة، تحويل إلى الإنسان عند الثقة المنخفضة
- الطريقة الصحيحة للتعاون مع coding agent: Jev يتخذ القرار، وأنت تراجع الأسئلة والعتبات، والـ agent يكتب الكود
بعد إتقان الأنماط، هل تريد رؤية كيف تُطبَّق في مشاريع حقيقية؟ المرحلة التالية سيناريوهات عملية: اختر مسارك تضم 15 حالة كاملة (مثل حواجز حماية LLM: طلب واحد يفحص بالكامل الرسائل الداخلة والخارجة لتطبيق LLM).
هل أنت مستعد؟ ابدأ بالدرس الأول: الأسئلة المتوازية والتفريع التخميني ←