المهارات

Brigade: مزامنة الأدوات والذاكرة بين harnesses وسجل عمل موحد للوكلاء البرمجيين في ملفات محلية

الأنسب لمن يحتاج إلى مزامنة الأدوات والذاكرة بين وكلاء البرمجة المختلفين (harnesses) والتقاسم سجل عمل محلي واحد؛ قبل الاستخدام جهّز Node.js 22+ وnpm، واطلع على الأثر الجانبي للقياس عن بُعد المتمثل في طلب الإصدار السلبي الذي أفصحت عنه الجهة الرسمية.

Official source · escoffier-labs/brigade

Install

npm install --global @escoffier-labs/[email protected]
brigade setup

لمن هذا مناسب

  • مناسب للمطورين الذين يستخدمون أكثر من وكيل برمجة في الوقت نفسه: عند التنقل بين عدة harnesses (مثل استخدام وكيل برمجة مختلف في أوقات مختلفة)، تريد أن تبقى الأدوات والذاكرة متزامنة وأن يتقاسم كل العمل سجلًا واحدًا، بدلًا من أن يحتفظ كل أداة بسجلها الخاص وحالات لا تتصل ببعضها. الوصف الرسمي: تشغيل وكلاء البرمجة في أي مكان مع الاحتفاظ بسجل واحد للعمل.
  • يأتي على هيئة أداة سطر أوامر (CLI): يأخذ الوكلاء أعمالًا جاهزة من سجل مشترك عبر عملية claim (الاستلام)، وتُقدَّم الذاكرة والمهارات إلى harnesses عبر MCP. يناسب من يرتاح لإدارة حالة عمل الوكلاء من سطر الأوامر وربط القدرات بسلسلة أدوات وكلاء قائمة عبر MCP.
  • يُحفظ سجل العمل في ملفات محلية دون الحاجة إلى خفي (daemon)، وهذا يناسب من يريد بقاء بيانات عمله على جهازه ولا يرغب في تشغيل خدمات خلفية إضافية؛ أما دعم التعاون بين عدة مستخدمين أو النشر عن بُعد فلا ذكر له رسميًا.
  • شرط الاستخدام: مسار التثبيت عبر npm يتطلب Node.js 22 أو أحدث مع npm. إذا لم تستوفِ بيئتك ذلك، فلا تقدم الوثائق الرسمية طريقة تثبيت بديلة ولا توضح ما إذا كانت هناك اختلافات بين أنظمة التشغيل.
  • لا تذكر الوثائق الرسمية الحالات غير المناسبة ولا تعطي قائمة بـ harnesses المدعومة. قبل الربط، تأكد أن عميل الوكيل لديك يستطيع إضافة خادم MCP عبر stdio — هذا أمر لا تتحقق منه الوثائق الرسمية نيابةً عنك؛ وإذا كانت سلسلة أدواتك لا تستطيع تشغيل CLI ولا الاتصال بـ MCP، فلا يوجد حاليًا مسار تكامل يمكن تأكيده.

أول محاولة في 3 دقائق

  • الشروط: جهّز Node.js 22 أو أحدث وnpm. تقول الوثائق الرسمية إن الاستخدام قد يرسل طلب إصدار سلبيًا واحدًا (passive version request) كأثر جانبي للقياس عن بُعد (telemetry)؛ هذا هو الأثر الشبكي الذي أعلنته الجهة الرسمية صراحة، وهو شرط يُقبل قبل الاستخدام، فينبغي الإلمام به عند التثبيت؛ وما عدا ذلك، هل هناك وصول شبكي آخر، المعلومات المتاحة لا تذكر.
  • المسار الرئيسي الموصى به واحد فقط: ثبّت الحزمة بإصدارها المثبَّت عالميًا عبر npm ثم نفّذ التهيئة وفق الخطوات الرسمية:
npm install --global @escoffier-labs/[email protected]
brigade setup
  • إطلاق المحاولة الأولى: اجعل الوكيل ينفّذ brigade work claim --next --actor codex ليستلم عملًا جاهزًا واحدًا من السجل المشترك — هذا هو سير العمل الأساسي الذي عرضه الرسميون. انتبه: الاستلام فعل «أخذ العمل الجاهز بعيدًا»؛ كيف تتغير حالته في السجل بعده وهل يمكن التراجع غير مذكور، فتعامل معه كعملية تمس السجل.
  • إن لم ترغب بعد في أن يستلم الوكيل أعمالًا، فابدأ بتشغيل brigade memory serve-mcp --stdio محليًا بوضع stdio، واربطه بـ harness كخادم MCP، ولاحظ إن كان يمكن قراءة ذاكرة Brigade ومهاراتها عبر MCP — هذه الخطوة لا تتضمن أي استلام.
  • إشارة النجاح: يحصل الوكيل على عمل جاهز عبر أمر الاستلام، أو يقرأ الـ harness ذاكرة Brigade ومهاراتها عبر MCP. سلوك brigade setup التفصيلي ومخرجاته عند النجاح غير موصوفين رسميًا؛ فإن لم يتصرف الأمر كما توقعت، تأكد أولًا من أن إصدار Node.js يستوفي الشرط، ثم قارن الخطوات مع المستودع الرسمي.

حالات الاستخدام

  • الحالة 1: مشاركة عدة وكلاء سجل عمل واحد. السيناريو: تستخدم أكثر من وكيل برمجة وتريد مكانًا موحدًا يبيّن «من يفعل ماذا وإلى أي حد»، بدلًا من أن يتناثر كل شيء في جلسات منفصلة وتفقد السياق عند كل تبديل أداة. البدء: بعد التثبيت وbrigade setup، اجعل الوكيل ينفّذ brigade work claim --next --actor codex عند بدء المهمة. سير العمل: work claim — يأخذ الوكيل عملًا جاهزًا واحدًا من السجل المشترك. ما يمكن توقعه: يُستلم ذلك العمل، ويُحفظ السجل في ملفات محلية دون خفي؛ كيف يُحدَّث السجل بعد الاستلام وكيف يُطَّلع على كل العمل غير مذكور رسميًا، وما يمكن تأكيده حاليًا ينتهي عند خطوة الاستلام.
  • الحالة 2: تقديم الذاكرة والمهارات إلى harness. السيناريو: تريد أن يستخدم الـ harness عند معالجة المهام الذاكرة والمهارات التي تحتفظ بها Brigade، بدلًا من أن تحتفظ كل أداة بنسختها دون اتصال بينها. البدء: شغّل brigade memory serve-mcp --stdio بوضع stdio واربطه بالـ harness كخادم MCP. سير العمل: memory serve-mcp — تكشف Brigade عبر هذا الخادم الذاكرة والمهارات للـ harness. ما يمكن توقعه: يستطيع الـ harness قراءة الذاكرة والمهارات عبر MCP؛ كيف يسجّل عميلك خادم MCP عبر stdio وما الواجهات القابلة للاستدعاء بعد الربط غير مذكور رسميًا، فاربطه بالطريقة المعتادة في harness الذي تستخدمه ثم تحقق.

حدود الاستخدام

  • الوصول إلى الشبكة: تذكر الوثائق الرسمية إمكانية إرسال طلب إصدار سلبي واحد كقياس عن بُعد، وهذا ما كشفته الجهة الرسمية من تلقاء نفسها؛ وما عدا ذلك لا ذكر لوجود وصول شبكي آخر، فلا تعده أداة محلية منفصلة عن الشبكة تمامًا.
  • الملفات والآثار الجانبية: يُحفظ سجل العمل في ملفات محلية دون خفي؛ الاستلام يأخذ عملًا جاهزًا من السجل المشترك وإمكانية التراجع غير مذكورة؛ التغييرات التي يحدثها التثبيت وbrigade setup في النظام لم تُفصَّل رسميًا بندًا ببند.
  • بيئة التشغيل والعميل: مسار npm يتطلب Node.js 22 أو أحدث وnpm؛ قائمة harnesses المدعومة غير مؤكدة، والتحقق من عمل harness الذي تستخدمه مسؤوليتك.
  • الإصدار وغيره: أمر التثبيت مثبَّت عند 0.30.0، والإصدارات الأخرى وطرق الترقية غير مؤكدة؛ طريقة إضافة أعمال أو مطالعة كل العمل أو الكتابة في الذاكرة والمهارات عدا الاستلام لا تغطيها المعلومات الرسمية المتاحة. قبل إدخاله في سير عملك اليومي، جرّبه على نطاق صغير، وتأكد أن السلوك يطابق التوقعات، ثم وسّع الاستخدام.