Skip to content

سير عمل فعال: أربعة أنماط معمارية بالتكامل مع 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.8512 دقيقة
3.3 التقييم المركّبحالة فرز السير الذاتية: 4 أبعاد يُقيَّم كل منها بـ Score، ثم تُدمج مرجّحةً بعد التطبيع؛ إذا لم يعجبك الترتيب فعدّل الأوزان، لا الـ prompt10 دقيقة
3.4 التطوير بالتكامل مع Claude CodeJev ليست نموذجًا لـ coding agent — ثبّت TypeSafe Agent Skill ليكتب الـ agent كودًا يستدعي Jev؛ 3 أمثلة prompt رسمية و5 أسئلة شائعة10 دقيقة

💡 جرّبه الآن

Agent Skill الخاص بـ TypeSafe في الدرس 4، يمكن تثبيته بأمرين فقط داخل Claude Code:

bash
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).


هل أنت مستعد؟ ابدأ بالدرس الأول: الأسئلة المتوازية والتفريع التخميني ←

gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.