هندسة Harness
اعتبارًا من 2026-11-12، هندسة harness هي عمل بناء البيئة المحيطة بالنموذج وصيانتها: التعليمات التي يقرأها وكيل، والأدوات والأذونات التي يمكنه استخدامها، والاختبارات وأدوات lint التي تخبره بما إذا كان التغيير سليمًا، والملفات التي تنقل التقدم إلى الجلسة التالية. إنها الجيل الثالث: بما يتجاوز Prompt Engineering وContext Engineering، ينقل النموذج الفكري لعام 2026 لبناء أنظمة وكلاء الذكاء الاصطناعي الموثوقة عمل المهندس إلى تصميم البيئات، وتحديد النية، وبناء حلقات التغذية الراجعة.
مفتاح واحد لـ Claude وGPT والنماذج الصينية — طبّق ما تصفه هذه الصفحة.
- الفوترة حسب token — الأسعار المباشرة على /models
- الدفع بالبطاقة (Visa / Mastercard) أو Apple Pay أو Google Pay أو العملات الرقمية
- خدمة ذاتية: شحن الرصيد والتفعيل فورًا
آخر تحديث 2026-11-14
ثلاثة أجيال من نماذج الهندسة
من «كيف تكتب prompts أفضل» إلى «كيف تبني أنظمة وكلاء موثوقة»
هندسة prompt
التركيز على صياغة تعليمات إدخال أفضل
هندسة السياق
تصميم ما يستطيع النموذج «رؤيته» — الذاكرة والأدوات والمستندات
هندسة Harness
تصميم البيئة الكاملة لتنفيذ الوكيل: القيود، وحلقات التغذية الراجعة، وإدارة دورة الحياة
المعادلة الأساسية: Agent = Model + Harness
إن لم تكن النموذج، فأنت جزء من منظومة Harness. منظومة Harness هي كل البنية التحتية التي تجعل وكيل ذكاء اصطناعي يعمل بموثوقية — CLAUDE.md، وأدوات MCP، وأتمتة Hooks، وقيود الأذونات، وآليات التغذية الراجعة.
Agent
Model
Harness
المكوّنات الأربعة لمنظومة Harness
القيود
حدّد ما يستطيع الوكيل فعله وما لا يستطيعه. إعدادات الأذونات في Claude Code، والتحكم في الوصول إلى الأدوات، ومواصفات المشروع في CLAUDE.md
حلقات التغذية الراجعة
أخبر الوكيل بما إذا كانت المهام قد نجحت. نتائج الاختبارات، وفحص الشيفرة، وإشارات CI/CD، ونقاط مراجعة بشرية
السقالات السياقية
زوّد الوكيل بالمعلومات المناسبة تمامًا. ذاكرة المشروع في CLAUDE.md، وتكاملات أدوات MCP، واسترجاع المستندات عبر RAG
إدارة دورة الحياة
أدر بدء تشغيل الوكيل وتنفيذه وإيقافه. أتمتة Hooks، وقوائم المهام، ومعالجة الأخطاء، واستمرارية الجلسة
خطة الفرق من QCode: بنية تحتية جاهزة لـ Harness
توفر خطة الفرق من QCode لوحة تحكم إدارية مستقلة، وإدارة أذونات مفاتيح API الفرعية، ومراقبة الاستخدام — منظومة Harness كاملة جاهزة للاستخدام. دع فريقك يركز على منطق الأعمال، لا على البنية التحتية.
ابدأ ببناء منظومة Harness للذكاء الاصطناعيهندسة Harness في الممارسة: من أين جاء المصطلح، وما الذي تتضمنه منظومة Harness، وكيف تبدأ
من أين جاء المصطلح
هندسة Harness هي العمل على بناء كل ما يحيط بالنموذج بما يسمح للوكيل بالقيام بعمل موثوق. في 2026-02-11 نشرت OpenAI مقالًا بعنوان «هندسة Harness: الاستفادة من Codex في عالم يعتمد الوكلاء أولًا»، يصف فريقًا بنى منتجًا داخليًا باستخدام Codex ومن دون شيفرة مكتوبة يدويًا. وجاء في سطره الملخّص: «البشر يوجّهون. الوكلاء ينفّذون.»، ويقول إن الوظيفة الأساسية للفريق أصبحت تصميم البيئات، وتحديد النية، وبناء حلقات تغذية راجعة تسمح لوكلاء Codex بالقيام بعمل موثوق.
تستخدم Anthropic المصطلح نفسه. مقالها الهندسي «منظومات Harness فعّالة للوكلاء طويلة التشغيل»، المنشور في 2025-11-26، يسمي Claude Agent SDK منظومة Harness قوية وعامة الغرض للوكيل، ويقول منشور في مدونة Claude بتاريخ 2026-06-02 إن Claude، بفضل تدفقات العمل الديناميكية، يمكنه الآن كتابة منظومة Harness الخاصة به أثناء التشغيل.
أربع ممارسات من مقال OpenAI
يحذر المقال أيضًا من أن هذا السلوك يعتمد اعتمادًا كبيرًا على بنية ذلك المستودع وأدواته، ولا ينبغي افتراض أنه قابل للتعميم من دون استثمار مماثل.
- خريطة لا دليلًا: أبقِ AGENTS.md قصيرًا (نسخة OpenAI نحو 100 سطر) واستخدمه كجدول محتويات يشير إلى وثائق أعمق في المستودع. وبكلمات المقال: امنح Codex خريطة، لا دليل تعليمات من 1,000 صفحة.
- المستودع هو نظام السجلات: أي شيء لا يستطيع الوكيل الوصول إليه في السياق أثناء التشغيل لا وجود له فعليًا بالنسبة إليه، لذلك تُحفظ وثائق التصميم وخطط التنفيذ ومتتبع الدين التقني تحت إدارة الإصدارات في المستودع.
- فرض البنية المعمارية آليًا: تفرض أدوات lint المخصصة والاختبارات الهيكلية اتجاهات الاعتماد، والتسجيل المنظم، وحدود حجم الملفات، وتحمل رسائل أخطاء lint إرشادات الإصلاح للوكيل.
- جمع النفايات المستمر: توجد المبادئ الذهبية في المستودع، وتفحص مهام Codex الخلفية المتكررة الانحرافات وتفتح طلبات سحب صغيرة لإعادة الهيكلة.
منظومة Harness لدى Anthropic للوكلاء طويلة التشغيل
يتكون نهج Anthropic من جزأين. يقوم وكيل تهيئة بإعداد البيئة في التشغيل الأول: سكربت init.sh، وملف claude-progress.txt يسجل ما فعله الوكلاء، وإيداع git أولي. وفي كل جلسة لاحقة، يحقق وكيل البرمجة تقدمًا تدريجيًا، ميزة واحدة في كل مرة، وينتهي بإيداع git وتحديث للتقدم.
قائمة الميزات بصيغة JSON، وتذكر المقالة أن النموذج أقل عرضة لتغييرها أو الكتابة فوقها على نحو غير مناسب مقارنة بـ Markdown؛ تبدأ كل ميزة بحالة فشل ولا تُعلَّم كناجحة إلا بعد اختبار دقيق. تذكر المقالة أيضًا أن تزويد Claude بأدوات اختبار مثل أتمتة المتصفح، وطلب اختباره من البداية إلى النهاية كما يفعل مستخدم بشري، قد حسّن الأداء بشكل كبير.
أنشئ أول harness في Claude Code أو Codex
كل هذا إعداد محلي ويعمل بالطريقة نفسها أياً كانت خدمة النموذج التي تستخدمها. مع QCode، يستخدم Claude Code وClaude Agent SDK المتغير ANTHROPIC_BASE_URL=https://api.qcode.cc/api، ويستخدم Codex القيمة base_url = https://api.qcode.cc/openai في config.toml، ويعمل مفتاح واحد يبدأ بـ cr_ مع كليهما. الفوترة لكل token؛ وأسعار كل نموذج مدرجة على /models.
- التعليمات: يقرأ Claude Code ملف CLAUDE.md في بداية كل جلسة (ويصوغ /init واحدًا)؛ يقرأ Codex ملف AGENTS.md، مع ~/.codex/AGENTS.md كطبقة عامة وملفات المشروع تُضاف فوقها كطبقات، بحد أقصى 32 KiB مجتمعة افتراضيًا.
- القيود: تُقيَّم قواعد الأذونات في Claude Code بالترتيب deny ثم ask ثم allow؛ وفي Codex، تُضبط إعدادات sandbox والموافقة على الجلسة الأم وترثها الوكلاء الفرعية.
- التغذية الراجعة: تعمل hooks في Claude Code عند نقاط مثل PreToolUse وPostToolUse وStop، ويؤدي hook من نوع PreToolUse يخرج بالرمز 2 إلى حظر استدعاء الأداة؛ ويوفر Codex أيضًا hooks من نوع PreToolUse وPostToolUse وStop.
- إعادة الاستخدام: غلّف إجراءً ثابتًا على شكل skill (ملف SKILL.md)، أو دع Claude Code يبني harness مخصصًا للمهمة عبر workflow ديناميكي.
- الاستمرارية: احتفظ بملف تقدّم مع commits في git، كما في إعداد Anthropic، حتى تتمكن الجلسة التالية من متابعة العمل من حيث توقفت السابقة.
الأسئلة الشائعة حول harness engineering
ما هو harness engineering؟
اعتبارًا من 2026-11-12، تعني هندسة harness تصميم البيئة التي يعمل فيها وكيل ذكاء اصطناعي بحيث ينتج نتائج موثوقة: التعليمات التي يقرأها، والأدوات والأذونات التي يملكها، وحلقات التغذية الراجعة مثل الاختبارات وأدوات lint، وكيف يُسجَّل التقدم عبر الجلسات. استخدمت OpenAI المصطلح عنوانًا لمقالها المؤرخ 2026-02-11 «Harness engineering: leveraging Codex in an agent-first world».
كيف يختلف harness engineering عن prompt engineering وcontext engineering؟
يهتم prompt engineering بصياغة التعليمات، وcontext engineering بما يستطيع النموذج رؤيته. يغطي harness engineering بيئة العمل بأكملها: القيود، وحلقات التغذية الراجعة، والذاكرة عبر الجلسات، والتحكم في دورة الحياة. وفي صياغة OpenAI، يتحول عمل المهندسين إلى تصميم البيئات وتحديد المقصود وبناء حلقات التغذية الراجعة.
هل Claude Code نفسه harness؟
نعم. تصف مدونة Anthropic الهندسية Claude Agent SDK بأنه harness عام الغرض للوكلاء، وتصف مدونة Claude harness الافتراضي في Claude Code بأنه مبني للبرمجة. وما تضيفه فوقه، مثل CLAUDE.md والأذونات وhooks وskills وworkflows، هو harness مشروعك الخاص.
ما مكوّنات harness؟
قائمة تحقق عملية: ملف تعليمات (CLAUDE.md أو AGENTS.md) يعمل كخريطة؛ قواعد أذونات أو sandbox؛ تغذية راجعة من الاختبارات وlinters وCI وhooks؛ ملف تقدّم إضافة إلى تاريخ git حتى تتمكن جلسة جديدة من اللحاق بسرعة؛ وإجراءات قابلة لإعادة الاستخدام مثل skills أو workflows محفوظة.
من أين أبدأ؟
اكتب ملف CLAUDE.md أو AGENTS.md قصيرًا يشير إلى وثائق أعمق، وأضف hook أو فحص CI يشغّل اختباراتك، وقسّم العمل إلى ميزة واحدة لكل جلسة، واحتفظ بملف تقدّم يحدّثه الوكيل في نهاية كل جلسة. أضف مزيدًا من البنية بعد أن ترى الوكيل يفشل بطريقة قابلة للتكرار.
كيف أدفع مقابل QCode لتشغيل Claude Code وCodex؟
ببطاقات الائتمان (Visa، Mastercard)، وApple Pay، وGoogle Pay، وAlipay، وWeChat Pay، أو بالعملات المشفرة عبر عدة عملات وشبكات. مفتاح واحد يتيح استدعاء Claude وGPT والنماذج الصينية الرائدة؛ الإعداد ذاتي الخدمة بالكامل ويستغرق بضع دقائق.
ابدأ ببناء منظومة Harness للذكاء الاصطناعي
توفر خطة الفرق من QCode لوحة تحكم إدارية مستقلة، وإدارة أذونات مفاتيح API الفرعية، ومراقبة الاستخدام — منظومة Harness كاملة جاهزة للاستخدام. دع فريقك يركز على منطق الأعمال، لا على البنية التحتية.
قراءات إضافية
مقارنة منسّقات البرمجة بالذكاء الاصطناعي مفتوحة المصدر لعام 2026
15 أداة جنبًا إلى جنب وفق نجوم 2026-09-22، والتراخيص، والنشاط، والشكل؛ لا يحمل عمودا الشكل ومصدر النموذج إلا ما يذكره كل README حرفيًا. تم التحقق في 2026-10-19.