الإجابة السريعة: لتقسيم مشروع صعب بين وكيلَي برمجة، امنح كل وكيل دورًا يُنتج شيئًا يمكن للآخر التحقق منه: أحدهما يستكشف ويكتب ما تعلّمه في ملف، والآخر يبني اعتمادًا على ذلك السجل، أو يحاول كلاهما تنفيذ الخطوة نفسها وتقوم أنت بمقارنة النتائج. احتفظ بالسياق المشترك في ملف واحد يقرأه كلا الوكيلين، وضع موافقة بشرية قبل أي إجراء يمس العالم الحقيقي.
طوّرٌ ما لا منفذ OBD2، وهو مقبس التشخيص القياسي في السيارات الأحدث، في جيب شيروكي موديل 1994 الخاص به، وبعبارة هو «لا توجد أداة فحص تعمل عليه». لم يستطع أي شيء قراءة كمبيوتر المحرك (ECU) الخاص به. فوصّل Arduino Nano بقيمة 3 دولارات إلى مقبس التشخيص وسلّم المهمة إلى وكيلَي برمجة: Claude Code وCodex. اجتذب فيديو هذا المشروع 450 نقطة وأكثر من 230 تعليقًا على Hacker News هذا الشهر.
الجزء المفيد لفريقك هو كيف حمل وكيلان مختلفان مشروعًا واحدًا صعبًا وغير مألوف، مع إنسان واحد حذر. يحوّل هذا الدليل تلك التجربة إلى نمط قابل لإعادة الاستخدام، ويبيّن أين يتناسب Sharkly بعد أن يتجاوز الوكيلان حدّي تبويبَي طرفية.
ما الذي يُظهره مشروع ECU في الجيب عن العمل بوكيلَي برمجة
هذا ما تقوله المصادر، ولا شيء غيره. في وصف الفيديو، يكتب المؤلف أن الوكيلين خلال أسبوع تقريبًا «قرأا الكمبيوتر مباشرة، وسجّلا رحلات القيادة، ونسخا برنامجه بالكامل، وشغّلا شيفراتهما الخاصة داخله». تُنسب قائمة الفصول إلى Claude مهمة اكتشاف التوصيلات وإجراء اختبار مضخة الوقود، وإلى Codex تشغيل شيفرة داخل الكمبيوتر. أحد الفصول يحمل عنوان «رحلة القيادة الليلية: كانت الأداة مخطئة».
مستودع xj-scanner الناتج عن ذلك هو القطعة الأكثر إثارة للاهتمام. ثلاثة تفاصيل تلفت النظر:
- ملف تعليمات مشترك واحد. الملف
AGENTS.mdهو نقطة الدخول «لأي وكيل يعمل في هذا المستودع». وCLAUDE.mdسطر واحد يشير إليه، فيقرأ Claude Code وCodex القواعد نفسها. - معرفة مدوّنة. يحتوي مجلد
docs/على ترتيب أطراف المقبس، والبروتوكول، وكل معلمة مع معامل تحجيمها، ليبدأ الوكيل التالي من حيث انتهى سابقه. - نقاط توقّف إلزامية بشريًا. تنص القواعد على أن القراءة آمنة، لكن مسح رموز الأعطال وإعادة ضبط معايرة الوقود واختبارات المشغّلات التي «تحرّك عتادًا حقيقيًا» تتطلب كلٌّ منها موافقة الشخص أولًا.
لا ينشر الفيديو تقسيمًا رسميًا للأدوار، لذا تعامل مع التقسيم أدناه بوصفه نمطًا مستخلصًا من النتيجة، لا نسخة محرفة من جلساته.
متى يحتاج المشروع الصعب إلى وكيلَي برمجة
استخدم وكيلين عندما تكون كلفة الخطأ الواثق مرتفعة. الهندسة العكسية والترحيلات والبروتوكولات غير المألوفة وتصحيح الأخطاء دون وثائق كلها حالات مناسبة. الوكيل الثاني المدعوم بنموذج مختلف يمنحك قراءة مستقلة، والخلاف بينهما إشارة يمكنك التصرف بناءً عليها.
تجاوز الوكيل الثاني عندما تكون المهمة صغيرة ومحددة بدقة. تشير وثائق Sharkly حول Crews إلى النقطة نفسها بشأن التنسيق عمومًا: أسند العمل الصغير المحدد جيدًا إلى وكيل واحد، وأحضر فريقًا فقط عندما يلزم أحد لتفسير الهدف ودمج النتائج.
ثلاث طرق لتقسيم مشروع بين وكلاء البرمجة
اختر نمطًا واحدًا لكل مرحلة، لا لكل مشروع. الاستكشاف والبناء والاختبارات الحية المحفوفة بالمخاطر يتطلب كل منها تقسيمًا مختلفًا.
| النمط | الوكيل A | الوكيل B | استخدمه عندما |
|---|---|---|---|
| المستكشف والباني | يبحث، ويكتب النتائج في ملف | يبني اعتمادًا على تلك النتائج | المجال مجهول والوثائق شحيحة |
| محاولتان مستقلتان | يحل الخطوة منفردًا | يحل الخطوة نفسها منفردًا | الإجابة الخاطئة مكلفة ويصعب اكتشافها |
| الباني والمراجع | يكتب التغيير | يراجعه مقابل المواصفات والبيانات | التغيير واضح لكن المخاطرة مرتفعة |
المستكشف والباني: من يكتب الخريطة؟
مخرجات المستكشف وثيقة، لا شيفرة. في xj-scanner هي مجلد docs/: المقبس المقيس فتحةً فتحة، والبروتوكول، وجدول المعلمات. يعمل الباني انطلاقًا من ذلك الملف فلا يحتاج أبدًا إلى اكتشاف ترتيب الأطراف من جديد. وإذا اصطدم الباني بتناقض، يحدّث الوثيقة، فتبقى الخريطة المصدر الوحيد للحقيقة.
محاولتان مستقلتان: كيف تقارن بينهما؟
أعطِ كلا الوكيلين التوجيه نفسه والمدخلات نفسها، ولا تدع أيًّا منهما يطّلع على إجابة الآخر. ثم قارن المخرجات على بيانات تثق بها. بالنسبة لفك ترميز بروتوكول، فهذا يعني إطعام كليهما السجل الملتقط نفسه ومقارنة القيم المفكوكة. نتناول إعدادًا عادلًا لذلك في مقارنة صادقة بين Claude Code وCodex على الخطأ نفسه.
الباني والمراجع: ماذا يتحقق المراجع؟
يتحقق المراجع من الادعاءات مقابل الأدلة، لا من الأسلوب. عبارة «معايرة الوقود تُقرأ +40%» ادعاء؛ ويسأل المراجع هل صيغة التحويم صحيحة قبل أن يتصرف أحد بناءً عليه. قواعد xj-scanner تُدوّن ذلك: «القراءة التي تبدو خاطئة قد تكون مشكلة تحجيم». يتعمق دليلنا حول فرق Crews بنماذج مختلطة ومراجع منفصل أكثر في إقران عامل أرخص بمراجع أقوى.
كيف يتناقل وكيلان البرمجة السياق بينهما
الوكلاء لا يتشاركون الذاكرة، لذا يجب أن يعيش التسليم في الملفات وسجلات المهام. أربعة عناصر تحمل معظم الثقل:
- ملف تعليمات واحد يقرأه كلا الوكيلين. AGENTS.md هو الصيغة المفتوحة التي يقرأها Codex؛ ويقرأ Claude Code ملف
CLAUDE.md، وتوضح وثائق الذاكرة لديه إمكانية استيراد ملفات أخرى. وملفCLAUDE.mdمن سطر واحد يشير إلىAGENTS.mdيُبقي كليهما على القواعد نفسها. - وثيقة نتائج لكل مجال. ترتيب الأطراف والبروتوكولات والمفاجآت توضع في
docs/، لا في سجل محادثة يتلاشى. - السجلات بوصفها دليلًا مشتركًا. يكتب xj-scanner كل رحلة قيادة في
pc/logs/بصيغة CSV، ليتمكن أي من الوكيلين من تحليل الرحلة نفسها. - ملاحظة تسليم لكل خطوة. ماذا جُرِّب، وماذا نجح، وما لم يُتحقق منه بعد، والأمر التالي.
يمكن أن تكون ملاحظة التسليم بهذا القصر (قيم توضيحية، ليست من مستودع الجيب):
## Handoff: SCI read of live sensor data
- Done: Nano bridge sketch flashed, DEMO mode passes on the laptop side
- Confirmed: cavities 2 (ground), 3, 4 measured with key ON
- Unverified: fuel trim scaling; reading looks high on idle
- Next: Codex decodes pc/logs/xj_2026-11-03.csv with both scaling formulas
- Needs a human: any actuator test or code erase
لمزيد من الصيغ، انظر قوالب تسليم المهام بين وكلاء البرمجة والدليل حول الحفاظ على السياق عند التبديل بين وكلاء البرمجة.
أين يتحقق الإنسان من النتيجة
ضع إنسانًا عند كل خطوة يصعب التراجع عنها، وفي مكانها فقط. قواعد xj-scanner نموذج نظيف لذلك:
- قبل أي شيء مادي. «لا تدع شيئًا يُوصَّل أبدًا إلى فتحة 12 فولط». يقيس الشخص كل فتحة أولًا.
- قبل أي أمر مدمّر. مسح الرموز يمحو أيضًا بيانات الوقود المتعلمة، فيسأل الوكيل ويشرح.
- قبل الوثوق بتشخيص. «لا تخمّن تشخيصًا. اذكر ما تُظهره البيانات وما لا تُظهره».
- بعد أي مفاجأة. يقول فصل رحلة القيادة الليلية إن الأداة كانت مخطئة؛ فالبيانات الواقعية هي الفحص الذي لا يستطيع أي وكيل تجاوزه.
تنطبق القاعدة نفسها على فريق برمجيات. عمليات الدمج إلى main وترحيلات المخططات وأي شيء يرسل بريدًا إلكترونيًا أو ينفق مالًا يحصل على بوابة بشرية. وكل ما عدا ذلك يمكن أن يمر بين الوكلاء. وإذا كانت المراجعة عنق الزجاجة لديك أصلًا، اقرأ تصميم المراجعة لوكلاء متوازيين.
تشغيل تقسيم بوكيلين في Sharkly
في الطرفية، يعيش التقسيم في رأسك: أي تبويب يشغّل أي وكيل، ومن ينتظرك. ينقل Sharkly ذلك إلى مهمة.
توصّل Computer، ويكشف Sharkly أدوات الوكلاء عليه بوصفها Runtimes، مثل Claude Code وCodex. تنشئ Agent لكل دور. ثم تبني Crew: وكيل قائد إضافة إلى وكلاء المستكشف أو الباني أو المراجع، والأشخاص الذين يوافقون.
أسند المهمة إلى الـCrew وينفَّذ العمل بقيادة القائد أولًا، وفق وثائق Crews. يقرأ القائد تعليمات المهمة والـCrew، ويذكر أعضاء الـAgent الذين يحتاجهم، فيشغّل هؤلاء الأعضاء على المهمة نفسها وينشرون نتائجهم في محادثتها. ويجمع القائد النتائج. تصف أدوارك إرشادات الـCrew: متى يُستدعى المراجع، وكيف تُدمج محاولتان، ومتى يقرر إنسان.
تفصيلان مهمان لهذا النمط. يمكن لعمل المستودع استخدام git worktree منفصل لكل تشغيل، فلا يتجاوز وكيلان يحاولان الخطوة نفسها أحدهما الآخر (وثائق تنفيذ المهام). ولكل تشغيل حالة في سجل تنفيذ المهمة، فيمكنك رؤية أي وكيل في قائمة الانتظار أو قيد التشغيل أو انتهى دون فتح طرفيات.
بدائل لفريق Crew بوكيلين
لديك خيارات أخرى، وبعضها أنسب:
- وكيل واحد، جولتان. اطلب من الوكيل نفسه البناء ثم المراجعة في جلسة جديدة. أرخص، لكن النموذج نفسه يميل إلى تكرار نقاط عماه.
- طرفيتان، مستودع مشترك واحد. تناسب مشروع عطلة نهاية أسبوع مثل الجيب. لكن تتبعها يصبح صعبًا عند وجود مهام متعددة وزميل فريق. انظر تشغيل Claude Code وCodex معًا على قاعدة شيفرة واحدة.
- وكلاء متوازيون على مهام منفصلة. مفيد للإنتاجية، لا لمراجعة بعضهم بعضًا. انتبه إلى وكيلين يحرّران الملف نفسه.
الخلاصة
نجح مشروع الجيب لأن المعرفة عاشت في ملفات، ولأن الوكيلين قرأا القواعد نفسها، ولأن إنسانًا وقف أمام كل إجراء محفوف بالمخاطر. انقل تلك العادات الثلاث وسيصبح وكيلان البرمجة فحصًا متبادلًا بدل مصدرين من التخمينات الواثقة.
الخطوة التالية: اختر مهمة صعبة واحدة هذا الأسبوع، واكتب قواعد AGENTS.md وملاحظة التسليم الخاصة بها، وشغّلها كفريق Crew في Sharkly مع وكيل مراجع وإنسان يمنح الموافقة.
الأسئلة الشائعة
هل يمكن لـClaude Code وCodex العمل على المشروع نفسه؟
نعم. كلاهما يقرأ ملفات التعليمات في المستودع: يقرأ Codex ملف AGENTS.md، ويقرأ Claude Code ملف CLAUDE.md الذي يمكن أن يشير إلى AGENTS.md. امنح كلًّا منهما worktree منفصلًا أو خطوة منفصلة حتى لا يحرّرا الملفات نفسها في آنٍ واحد.
كيف يتشارك وكلاء البرمجة السياق؟
عبر الملفات وسجلات المهام، لا الذاكرة. احتفظ بالقواعد في AGENTS.md، والنتائج في مجلد وثائق، والبيانات الخام في السجلات، وملاحظة تسليم قصيرة لكل خطوة.
أين ينبغي أن يوافق إنسان على عمل الوكلاء؟
قبل أي شيء يصعب التراجع عنه: إجراءات العتاد، والأوامر المدمّرة، وعمليات الدمج إلى main، والترحيلات، وأي شيء يرسل رسائل أو ينفق مالًا. ودع الباقي يمر بين الوكلاء.
هل قام Claude Code وCodex بالهندسة العكسية لـECU الجيب من تلقاء نفسيهما؟
لا. قام المطوّر بالتوصيلات والقياسات والقيادة، وتتطلب قواعد المستودع موافقة الشخص قبل الأوامر الخطرة. أما الوكلاء فقرأا الكمبيوتر، وسجّلا الرحلات، ونسخا برنامجه، وشغّلا شيفرة داخله.
هل تحتاج إلى منصة لتشغيل وكيلَي برمجة؟
لا. طرفيتان ومستودع مشترك يكفيان لمشروع واحد. تبدأ المنصة في إثبات جدواها عندما تتدفق عدة مهام وزملاء وموافقات وتحتاج إلى سجل واحد لمن فعل ماذا.



