عن المشروع

هذا مستودع تعليمي يعلّم "هندسة الأدوات" (harness engineering) لوكلاء الذكاء الاصطناعي: أي الانضباط الخاص ببناء البيئة التشغيلية حول نموذج مدرَّب. وتتمثل أطروحته المركزية في أن الفاعلية (الإدراك والاستدلال والفعل) تأتي من تدريب النموذج، لا من تنسيق الكود الخارجي؛ فمنتج الوكيل هو نموذج + أداة تشغيل (harness). ويميّز ملف README بين الوكلاء الحقيقيين وبناة سير العمل القائمين على تسلسل المطالبات (prompt-chaining)، ويجادل بأن الذكاء لا يمكن هندسته عبر تكديس كود لاصق إجرائي. تتكون الدورة من 17 درسًا تدريجيًا (s01–s17)، يعزل كل منها آلية واحدة من آليات الأداة التشغيلية، ويقدّم تطبيق Python مستقلًا قابلًا للتشغيل (code.py)، وملفات README بالإنجليزية والصينية واليابانية، ومخططات SVG. وتغطي الدروس: - s01 حلقة الوكيل (حلقة واحدة + bash) - s02 توزيع استخدام الأدوات - s03 نظام الصلاحيات - s04 الخطافات (Hooks) حول الحلقة - s05 التخطيط عبر TodoWrite - s06 عزل سياق الوكيل الفرعي - s07 تحميل المهارات عند الطلب - s08 ضغط السياق - s09 أنظمة الذاكرة الفرعية (الاختيار والاستخلاص والتوحيد) - s10 نظام مهام مدعوم بالملفات - s11 المهام الخلفية - s12 الجدولة عبر Cron - s13 فرق الوكلاء مع المطالبات الذرية بالمهام وأشجار عمل مرتبطة بالمهام - s14 تكامل أدوات إضافات MCP - s15 أداة تشغيل متكاملة تعيد ربط جميع الآليات حول حلقة واحدة - s16 بيئة تشغيل سير العمل مع سجلات قابلة للاستئناف - s17 حلقة الهدف مع تقييم مستقل للتوقف يتبع التطبيق حلقة وكيل LLM عامة: رسائل داخلة، واستجابة خارجة، وتنفيذ كتل tool_use، وإلحاق النتائج، وتكرار الحلقة. ويضيف كل فصل آلية واحدة بالضبط حول هذه الحلقة الثابتة. ويُشار إلى Claude Code كنموذج لأداة تشغيل جيدة التصميم لأنه يوفر الأدوات وتحميل المعرفة وإدارة السياق وحدود الصلاحيات دون فرض سير عمل جامد. كما يحافظ المستودع على مسار قديم من 12 درسًا تحت docs/ وagents/ أثناء الترحيل، مع جدول ربط بالفصول الحالية. البدء السريع: استنساخ المستودع، ثم pip install requirements، ثم إعداد ANTHROPIC_API_KEY في .env، ثم تشغيل كود الفصل مثل python s01_agent_loop/code.py. ويتضمن نسخة تطبيق ويب تحت web/. ومن المشاريع المرافقة المذكورة: Kode Agent CLI وKode Agent SDK، إضافة إلى برنامج تعليمي شقيق (OpenClaw) حول أدوات تشغيل المساعد الدائم.