إعداد مكتب الوكلاء وتدبير عمّال البرمجة بالذكاء الاصطناعي ففضاء ثلاثي الأبعاد مشترك

شنو كيدير Agent Office

Agent Office كيحوّل تطوير البرمجيات بمساعدة الذكاء الاصطناعي لمكتب ثلاثي الأبعاد مشترك وبستايل كرتوني. كل مستودع GitHub كيولي طابق مستقل فيه مكاتب، وعاملين كيكوديو، وترمينالات، ولوحات ديال المشاكل وطلبات الدمج، وطابور ديال المهام، وخدمات، وإعدادات خاصة بالمشروع.

تقدر تقلس عامل ديال Claude Code ولا OpenCode ولا Codex فشي مكتب، وتتفرج فالترمينال ديالو مباشرة فالحاسوب اللي فوق المكتب، وتفتح نفس الترمينال مع أعضاء الفريق. العاملين يقدرو يخدمو فنسخة العمل الرئيسية ولا فـ Git worktrees معزولين، وهاد الشي كيخلي تشغيل بزاف ديال المهام بالتوازي ممكن بلا ما يتشاركو نفس مجلد العمل.

التطبيق كيوفر حتى الحركة الجماعية، والصوت، ومشاركة الشاشة، وسجل دائم للدردشة والترمينال، وإشعارات العاملين، ومراقبة الآلة، والتنقل بين المشاريع، وسير عمل ديال مشاكل وطلبات الدمج فـ GitHub، واجتماعات منظمة متعددة العوامل.

المفاهيم الأساسية

طابق واحد لكل مستودع

فأول مرة كيبدا فيها Agent Office، كيفتح فالمصعد وكيطلب منك تختار مستودع باين للحساب ديالك فـ GitHub CLI والمصادق عليه. وتقدر حتى تدخل المستودع بهاد الصيغة: owner/name.

كيتم استنساخ المستودع فـ:

~/agent-office/<owner>/<repo>

كل طابق ديال مشروع عندو العاملين والمكاتب واللوحات والطوابير والخدمات والصور والألوان ديالو بشكل مستقل. الناس اللي فطابق واحد كيشوفو وكيسمعو غير الناس اللي فداك الطابق.

العاملين فالمكاتب

المكتب الخاوي يقدر يستقبل Claude Code ولا OpenCode ولا Codex ولا shell مشترك ديال تسجيل الدخول. المكتب المشغول كيعرض الترمينال والحالة المباشرة ديال العامل. الـ hooks ولا الـ plugins ديال العاملين كيعلمو واش العامل خدام، كيتسنى شي إدخال، ولا سالا.

لوحات GitHub وأتمتة المهام

لوحة المشاكل كتنظم المشاكل فمجموعات: مفتوحة، قيد التنفيذ، ومغلقة. لوحة طلبات الدمج كتعرض المسودات والمراجعات والموافقات وعمليات الدمج والإغلاق وحالة CI وحجم الاختلافات. تقدر تعطي المهام مباشرة للعاملين ولا تزيدها للطابور الدائم باش تتنفذ أوتوماتيكيا.

المتطلبات الأساسية والتثبيت

الـ README المتوفر كيشرح كيفاش تستعمل Agent Office، ولكن ما فيهش أمر ديال التثبيت باستعمال مدير الحزم. ثبّت المشروع باستعمال تعليمات التوزيع ولا البناء ديال المستودع، ومن بعد تأكد بلي الملف التنفيذي agent-office متاح فـ shell ديالك.

قبل ما تبدا، صادق على حساب GitHub CLI اللي خاص السيرفر يستعملو:

gh auth status

إلا ما كانتش المصادقة مكمّلة، كمّل مسار تسجيل الدخول ديال GitHub CLI:

gh auth login

الحساب المختار كيحدد شنوما المستودعات اللي يقدر Agent Office يكتاشف، وشنو الهوية اللي غادي تستعمل فإجراءات GitHub بحال نشر تعليقات على المشاكل.

من الأحسن حتى يكون عندك على الأقل CLI واحد مدعوم ديال وكلاء البرمجة مضبوط فالآلة إلا كنت ناوي توظف عامل من داك النوع. Agent Office كيدعم العاملين ديال Claude Code وOpenCode وCodex.

بدا أول مكتب ديالك

شغّل التطبيق بهاد الأمر:

agent-office

1. فتح واجهة Agent Office فالمتصفح باستعمال العنوان اللي كيعرضو التطبيق.
2. استعمل محدد المشاريع ديال المصعد باش تختار مستودع متاح عبر gh، ولا كتب الاسم الكامل ديالو بصيغة owner/name.
3. تسنى حتى يستنسخ Agent Office المستودع داخل ~/agent-office.
4. اختار لون البشرة وتسريحة الشعر ولون الشعر والقميص ديال الشخصية ديالك.
5. دخل لطابق المشروع الجديد.

باش تزيد مشروع آخر ولا تزورو من بعد، دخل للمصعد اللي فالحيط الشمالي وضغط على E. وتقدر حتى تضغط على اسم المشروع فالجهة الفوقانية اليسرى وتختار طابق آخر.

إعدادات اختيارية عند التشغيل

الـ README كيوثق بزاف ديال الخيارات المفيدة ديال السيرفر. مثلا:

agent-office --city Berlin --max-workers 4

الخيار --city Berlin كيخلي الشروق والغروب والطقس يتبعو برلين. والخيار --max-workers 4 كيفرض حد أقصى على مستوى السيرفر لعدد العاملين اللي خدامين فآن واحد فكل الطوابق. الـ shells المشتركة وعوامل اللوحات كيتحسبو حتى هما ضمن هاد الحد.

تقدر تربط إشعارات الفريق بـ Slack ولا Discord باستعمال webhook وارد:

agent-office --webhook <incoming-webhook-url>

تحذيرات الميزانية وإيقاف التوظيف متاحين عبر --budget و--budget-pause. هاد الضوابط كتستعمل غير المصاريف المتتبعة ديال Claude Code. ما كتقدرش تحد مباشرة من مصاريف OpenCode ولا Codex، ولكن ملي كيتوصل حد التوظيف المتتبع، كيتوقفو جميع العاملين الجدد.

تعلّم الضوابط الأساسية

• WASD: تحرك فالمكتب.
• Space: نط.
• سحب بالماوس: دوّر الكاميرا.
• E: تفاعل مع المكاتب واللوحات والمصاعد والكراسي والسلالم وباقي عناصر المكتب.
• Tab: حل القائمة الرئيسية.
• T: قرا آخر سطور الدردشة.
• P: كتب مهمة قبل التوظيف فمكتب خاوي.
• B: حل shell مشترك ديال تسجيل الدخول فمكتب خاوي.
• C: تفقد التغييرات فمكتب مشغول.
• N: زور العامل اللي بقى كيتسنى أطول مدة.
• R: عاود كمّل جلسة عامل مدعوم اللي خرج.
• /: قلّب فالدردشة وسجل الترمينال ديال العامل.

القائمة الرئيسية كتحل نوافذ ديال العاملين والناس والمشاكل وطلبات الدمج والطابور والخدمات والبحث والصوت ومشاركة الشاشة والإعدادات ولوحات الحالة وغيرها. العناصر اللي كتستعمل بزاف تقدر تثبتها فالشريط العلوي، واختيارات التخطيط الخاصة بالمتصفح كيبقاو محفوظين.

وظّف أول عامل برمجة ديالك

1. سير لمكتب خاوي.
2. ضغط على E.
3. ختار Claude Code ولا OpenCode ولا Codex.
4. دخل المهمة اللي بغيتي العامل يكملها.
5. إلى كان مناسب، فعّل own git worktree.
6. أكد التوظيف وتفرّج فالتيرمينال ديال العامل وهو كيبان فالحاسوب المحمول.

تقدر تضغط على P فمكتب خاوي إلا بغيتي تصايب المهمة قبل ما تختار العامل. Agent Office فيها 16 مكتب. إلا كانو عامرين، محطات خدمة مؤقتة بوسادات الجلوس تقدر تستقبل حتى لـ12 عامل إضافي.

استعمل worktrees معزولين للمهام المتوازية

فعّل own git worktree ملي يكونو بزاف ديال العمال يقدرو يعدلو نفس المستودع فنفس الوقت. Agent Office كتنشئ فرع office/<name> وكتحط النسخة ديالو فـ:

.agent-office/worktrees/

هاد الشي كيمنع العمال اللي خدامين بالتوازي من تعديل نفس النسخة المحلية. ملي كتسرّح عامل خدام بـworktree، تقدر تخلي الفرع والـworktree، ولا تحيد غير الـworktree، ولا تحيد بجوج. Agent Office كتنبهك للتعديلات اللي ما تدارتش ليها commit وللكوميتات اللي ما وصلاتش للـremote.

باش تنقّي الـworktrees اللي خليتيهم من بعد ما يولي آمن، شغّل:

agent-office prune

حلّ وتعاون فـTerminal ديال العامل

ضغط على E فمكتب عامر باش تحل تيرمينال PTY الحقيقي ديالو عبر WebSockets. بزاف ديال المتعاونين يقدرو يكتبو فالجلسة فنفس الوقت، واللي كيدخل متأخر كيوصلو السجل السابق ديال التيرمينال.

رأس التيرمينال كيبين شكون حالّ التيرمينال دابا. وكيعرض حتى إشعار بالكتابة ملي شي واحد آخر كيدخل النص، باش ينقص احتمال يكتبو المتعاونين فوق إدخال بعضياتهم.

تيرمينالات العمال وآخر 3,000 سطر منها كيتحفظو. عمليات العمال كتخدم بوحدها على السيرفر الرئيسي، وبهذا يقدرو يكملو الخدمة حتى من بعد إعادة تحميل السيرفر ولا إعادة تشغيل العملية. التيرمينالات المحلولة كتعاد تربط أوتوماتيكيا ملي كيرجع السيرفر.

فهم الحالة المباشرة ديال العامل

الهوائي والحركة ديال العامل كيبينو الحالة ديالو. العمال يقدرو يبانوا بحال كيخدم، ولا كيحتاج إدخال، ولا سالِي. الحركة ديالهم كتعكس حتى أفعال بحال قراية الملفات، تعديل الكود، تشغيل الاختبارات، البحث فالويب، ولا مواجهة إخفاقات متكررة.

ملي كيحتاج العامل المساعدة ولا كيكمل المهمة ديالو، Agent Office كتشغل إشعار وكتدخل العامل فعدد اللي كيتسناو. ضغط على N باش تمشي لأقدم عامل كيتسنى. إلا بقيتي كتضغط على N، غادي تدوز بين العمال اللي كيتسناو.

راجع التعديلات وحلّ Pull Request

فمكتب عامر، ضغط على C ولا اختار Changes من التيرمينال. واجهة التعديلات كتعرض الملفات المعدلة وdiff كيتحدّث باستمرار مقارنة مع الفرع اللي تحل فيه المكتب.

من هاد الواجهة، تقدر:

• تعاين الملفات المعدلة وdiff ديالها.
• دير commit لتعديلات العامل.
• تحيد التعديلات اللي ما بغيتيش.
• تدفع الفرع.
• تحل pull request.

بالنسبة لعامل خدام بـworktree معزول، ضغط على O فالمكتب ملي تكون الخدمة واجدة. Agent Office كدفع الفرع وكتحل pull request بعنوان ووصف مصايبين انطلاقا من المهمة. الخدمة اللي جاية من issue فـGitHub كيتزاد فيها مرجع Closes #n. ضغط على O مرة أخرى باش تشوف pull request.

خدم مع Issues ديال GitHub

لوحة issues كتعرض الـissues المفتوحة، اللي خدام عليها، والمسدودة. اختار issue باش تقرا الوصف والتعاليق ديالها، وتنشر تعليق، وتصيفطها لعامل، ولا تزيدها لقائمة المهام.

وتقدر حتى ترفع بطاقة issue بيديك:

1. وجّه للمذكرة ديال issue وضغط على E، ولا استعمل Pick it up فنافذة issue.
2. دي البطاقة لمكتب خاوي باش توظف عامل جديد.
3. ديها لمكتب عامر باش تسلمها لذاك العامل.
4. ديها لقائمة المهام باش تزيدها للطابور.
5. ضغط على Q إلا بغيتي ترجع البطاقة للوحة.

ملي كيتوصل العامل ببطاقة issue، Agent Office كتعين داك issue عبر GitHub وكتنقلها للحالة ديال الخدمة الجارية. وتقدر حتى تسد الـissues كمكتملة ولا غير مخطط لها، مع تعليق اختياري.

راجع ودمج Pull Requests

لوحة PR كتجمع pull requests فحالات: مسودة، قيد المراجعة، مصادق عليها، مدمجة، ومسدودة. وكتعرض حتى حالة CI وحجم diff.

حلّ pull request واختار Files changed باش تعاين diff ديالها. الملفات يقدرو يبانوا فشجرة ديال المجلدات ولا فلائحة مسطحة. تعاليق المراجعة كيبانو تحت السطور المرتبطة بها.

• ضغط على V باش تعلم على الملف بأنه تراجع.
• استعمل J وK باش تدوز بين الملفات.
• اختار Review باش تسلّم PR لعامل.
• اختار Fix comments & merge باش العامل يعالج الملاحظات، ويخلي الاختبارات تدوز، ويدمج PR.
• إلا كان الفرع فيه تعارض مع الفرع الأساسي ديالو، استعمل Fix conflicts & merge.

Agent Office تقدر تدير squash ولا merge ولا rebase لـpull request. وتقدر حتى تطلب من GitHub يدمجها أوتوماتيكيا من بعد ما تدوز الاختبارات المطلوبة. ملي كتندمج pull request، المكتب كيطلق جرس الدمج، وكيطلق القصاصات الورقية، وكيحرك العمال النشيطين.

أتمت الخدمة بقائمة المهام

قائمة المهام متوفرة من السبورة اللي فالحايط الشمالي ولا من القائمة الرئيسية. زيد مهمة حرة النص ولا دخل issue للطابور، ومن بعد خلي Agent Office تعين الخدمة أوتوماتيكيا.

ملي كيكون مكتب متوفر وإعداد التزامن ديال الطابور كيسمح بعامل آخر، المهمة التالية كيتعيّن ليها عامل جديد فـGit worktree معزول. التزامن الافتراضي ديال الطابور هو ثلاثة ديال العمال. إلا عيّنت workers at once على صفر، كيتوقف الطابور مؤقتا.

الخدمة ديال القضايا اللي فالطابور كتتعيّن فـGitHub، ومنين كيظهر الـpull request الناتج كيرتابط فلوحة الطابور. العمال اللي سالاو الخدمة كيبقاو فمكاتبهم باش يتراقبو حتى كيحتاج الطابور داك البلاصة لمهمة خرى. حالة الطابور كتبقى محفوظة من بعد إعادة التشغيل.

استعمل وكلاء متخصصين ديال اللوحات

لوحة القضايا، ولوحة الـPR، وطابور المهام، كل وحدة فيهم عندها وكيل ديال الكشك. مشي للكشك وضغط على E باش تعطيه تعليمة.

• وكيل القضايا: كيقلب على القضايا، وكيصاوبها، وكيصنفها، وكيحط ليها الوسوم، وكيسدها باستعمال gh.
• وكيل الـPR: كيلخص pull requests، وكيراجعها، وكيعلق عليها، وكيدمجها.
• وكيل الطابور: كيحول الطلب لمهمة وحدة ولا كثر فطابور المهام، وكيعطي حالة الطابور، وكيحيد المهام.

وكيل الطابور ما كيطبقش تغييرات فالكود براسو. كينشئ مهام فالطابور باش العمال الجدد يقدرو يخدمو عليها فـworktrees معزولين. ضغط على O فالكشك باش تفحص التيرمينال ديالو، ولا على X باش تصيفط الوكيل لدارو.

نظم اجتماعات منظمة متعددة الوكلاء

قاعة الاجتماعات كتدعم مجموعات من جوج حتى لخمسة ديال العمال. بدا الاجتماع من القاعة، ولا من المينيو الرئيسي، ولا من قضية، ولا من pull request. كل مشارك عندو دور تقدر تعاود تسميه.

الأنماط المتاحة كتشمل:

• النقاش: العمال كيقدمو المقاربات، وكينتقدو بعضياتهم، وكيوصلو لقرار نهائي.
• القائد والفريق: قائد كيفرق المهمة، وكيوكل الأجزاء للآخرين، وكيدمج النتائج.
• Map-reduce: العمال الموزعون كيعالجو ملفات، ولا وحدات، ولا قضايا، ولا أجزاء خرى بشكل منفصل، ومن بعد عامل واحد كيدمج الخلاصات.
• الأحمر / الأزرق: عمال الفريق الأحمر كيقلبو على الأخطاء، ومخاطر الأمان، والحالات الحدية، بينما عمال الفريق الأزرق كيتعاملو مع الملاحظات الصحيحة.
• لجنة المراجعة: المراجعون كيفحصو pull request من زوايا مختلفة، ومن بعد القائد كيدمج المراجعة وكينشرها.

كل اجتماع كيحدد ملف ديال الخرج وكيخدم ففرع ديالو. منين كيكون الخرج واجد، استعمل Open PR باش تصاوب pull request. الاجتماعات عندها حدود ديال الجولات وميزانية ديال التوكنات على مستوى الطابلة، وهادشي كيمنعها من الاستمرار بلا نهاية.

راقب الخدمات، والموارد، والمصاريف

خدمات التطوير

منين كيشغل عامل سيرفر ويب بحال npm run dev، ولا preview build، ولا python -m http.server، كيبان فلوحة الخدمات فغضون بضع ثواني. كل إدخال كيبين العامل، والفرع، وعنوان الصفحة. منين كتختارو، كينسخ أمر باش تحل داك السيرفر من الكمبيوتر ديالك.

ضغط الجهاز وحدود العمال

المونيتور اللي فالحايط الغربي كيبين الاستعمال الحالي ديال CPU والذاكرة، والسجل ديال خمس دقايق، وعدد العمال اللي خدامين. إلا وصلات الذاكرة لـ90 فالمية، ولا بقى الـCPU خدام بنسبة 90 فالمية تقريباً نص دقيقة، Agent Office كينبهك بلي الجهاز مضغوط.

القيمة ديال --max-workers على مستوى السيرفر كتوفر سقفاً إجبارياً. المسؤول يقدر ينقص الحد النشيط فالإعدادات، ولكن ما يقدرش يطلعو فوق القيمة اللي تحددات عند التشغيل. منين كتكون الطاقة كاملة، التوظيف اليدوي كيرفض مع تفسير، بينما المهام اللي فالطابور كتستنى حتى تفتح بلاصة.

تقارير الاستعمال والتكلفة

عمال Claude Code كيسجلو تكلفة الجلسة والتوكنات المتتبعة. OpenCode كيسجل التوكنات وتقديرات النموذج والمزود، وكيشمل الجلسات الفرعية إلا كانت متاحة. Codex كيسجل توكنات الجلسة الجذرية، بما فيها تفاصيل الكاش والاستدلال، ولكن ما كيسجلش التكلفة ولا عدد نداءات الـAPI.

فعّل Claude limits من المينيو باش تبان ليك الاستفادة من خطة Claude ديال جلسة الخمس ساعات، والحصة الأسبوعية، وأي حد أسبوعي خاص بنموذج معين. هاد اللوحة كتختافي منين كيستعمل Claude مفتاح API بلاصة الخطة، وما كتشملش OpenCode ولا Codex.

نصائح متقدمة للتعاون

• استعمل worktrees بشكل افتراضي فالبرمجة المتزامنة: هادشي كيمنع العمال من تقاسم الملفات اللي ما تسجلاتش ولا من تبديل فروع بعضياتهم.
• فرق بين التخطيط والتنفيذ: استعمل وكلاء القضايا والطابور لتنظيم الخدمة، ومن بعد خلي عمال جداد فـworktrees يديرو تغييرات الكود.
• خلي التزامن ديال الطابور أقل من حد الجهاز: خلي الطاقة متاحة للعمال التفاعليين، والأصداف المشتركة، ووكلاء اللوحات.
• استعمل إشعارات سطح المكتب: تقدر توصلك مباشرة لعامل محتاج الإدخال ديالك ولا سالا خدمتو، حتى إلا كانت تاب ديال المكتب فالخلفية.
• ضبط webhooks ديال الفريق: إشعارات Slack ولا Discord كيساعدو الفريق يلاحظ العمال اللي بقاو بلا مراقبة.
• قلب قبل ما تعاود تحل الجلسات: ضغط على / باش تقلب فالمحادثة وفجميع مخرجات التيرمينال المحتافظ بها، حتى التاريخ اللي كان قبل إعادة التشغيل.
• استعمل shell مشتركة لخدمات الدعم: ضغط على B فمكتب خاوي منين تحتاج تيرمينال تعاونية للاختبارات، ولا أوامر Git، ولا سيرفرات التطوير بلا ما توظف عامل ديال الذكاء الاصطناعي.
• فحص قبل ما تصيفط العمال لدارهم: راجع تاريخ التيرمينال والتغييرات، ومن بعد قرر واش تخلي فرع العامل وworktree ديالو ولا تحيدهم.

الخلاصة

Agent Office كيجمع وكلاء البرمجة بالذكاء الاصطناعي، وworktrees ديال Git، والتيرمينالات المشتركة، ولوحات GitHub، والطوابير، والإشعارات، والتعاون متعدد اللاعبين فواجهة مكانية وحدة. بدا بطابق واحد ديال المشروع وبعامل واحد معزول، ومن بعد دخل المهام فالطابور، ووكلاء اللوحات، وسير العمل ديال pull requests، والاجتماعات المنظمة ملي يولي الفريق مرتاح مع التطوير المتوازي بمساعدة الذكاء الاصطناعي.