هندسة الهارنس: كيف تبني وكيل ذكاء اصطناعي موثوقًا

هندسة الهارنس (harness engineering) تخصص يهتم ببناء بيئة حول نموذج لغوي، تتيح لوكيل الذكاء الاصطناعي إنجاز العمل الحقيقي بموثوقية. المعادلة: الوكيل = النموذج + الهارنس. قد يعمل النموذج نفسه في مشروع كمطوّر متمرس، وفي مشروع آخر يفقد السياق ويُبلغ عن ميزة لا تعمل بأنها «مكتملة». والفرق في معظم الحالات يكمن في الهارنس، لا في النموذج.

هذا الدليل خريطة للموضوع. يجمع المفاهيم الأساسية وترتيبًا مقترحًا لتعلمها. ولكل موضوع مقالة تفصيلية مستقلة.

مكونات الهارنس الخمسة

• التعليمات——ملفات CLAUDE.md وAGENTS.md، والوثائق المتخصصة، وskills: ما يعرفه الوكيل عن المشروع.
• الأدوات——shell، وتحرير الملفات، والمتصفح، وخوادم MCP: ما يتصرف به الوكيل.
• البيئة——صناديق الرمل، والحاويات، ونسخ العمل المعزولة: مكان تنفيذ الوكيل للأوامر.
• الحالة——ملفات الخطة والتقدم، وسجل git: ذاكرة تنتقل بين الجلسات.
• التغذية الراجعة——الاختبارات والمدققات والخطافات والمراجع المستقل: ما يعرف به الوكيل أخطاءه.

تشكّل هذه المكونات حلقة مغلقة. إذا أُزيل أحدها انقطعت الحلقة: دون فحوصات لا يرى الوكيل أخطاءه، ودون حالة تبدأ كل جلسة من الصفر.

من أين تبدأ

إذا كان الموضوع جديدًا عليك، فابدأ بالمقالة التي تشرح ما هي هندسة الهارنس، وكيف تختلف عن هندسة الأوامر وهندسة السياق. وللتعريف المختصر لهارنس الوكيل مع مثال، راجع مقالة تعريف الهارنس.

ثم انتقل إلى التطبيق. أول ملف يواجهه كل شخص هو ملف تعليمات المشروع: ماذا يُكتب في CLAUDE.md وAGENTS.md وما الذي لا يُكتب، ولماذا يتجاهل الوكيل قاعدة مكتوبة صراحةً في الملف.

وعندما يعمل الوكيل فعلًا في المشروع، تصبح الموثوقية هي المسألة. تبدأ الخطة المرحلية من سجل الإخفاقات ومؤشرات MTBF وMTTR، مرورًا بالتراجع المنخفض التكلفة وحلقات التغذية الراجعة والذاكرة المحفوظة في الملفات، وصولًا إلى حلقة مستقلة يعمل فيها الوكيل ساعات دون إشراف.

المبادئ الأساسية

• الوكيل ليس معطوبًا، بل البيئة المحيطة به. ابحث عن الثغرة في الهارنس أولًا، ولا تغيّر النموذج.
• ابدأ بالتغذية الراجعة: أمر تحقق واحد يفيد أكثر من صفحة تعليمات.
• التعليمات خريطة وليست كتابًا مدرسيًا: ملف دخول قصير، والتفاصيل عند الحاجة.
• الأشياء المهمة تعيش في الملفات، لا في نافذة السياق.
• قِس الأمور: سجل إخفاقات بدلًا من الانطباعات.

وقد شرحنا كل نظام فرعي من أنظمة الهارنس، وطريقة تجميع الهارنس كاملًا، عمليًا في دورة هندسة الهارنس.