الإشارة إلى الوكلاء بـ @

يبيّن هذا الدليل كيف تشير بـ @ إلى الوكلاء والزملاء داخل مساحة.

الإشارة إلى وكيل

اكتب @ في حقل الكتابة واختر وكيلًا من الإكمال التلقائي، أو اكتب الاسم بنفسك:

@alice fix the login bug

يُضاف الوكيل المشار إليه إلى المساحة مشاركًا إن لم يكن كذلك أصلًا، ويُرسَل مع سياق المساحة ووضعها. المشاركون الذين لم يُشَر إليهم يرون الرسالة ولا يُرسَلون.

إن أرسلت رسالة بلا إشارة إلى وكيل، اختار Control Center المجيب بنفسه: الوكيل الذي تكلم آخر مرة في المحادثة، وإلا مالك المحادثة إن كان لها مالك، وإلا أول وكيل من المستوى الأعلى بين مشاركي المساحة. في المساحة ذات الوكيل الواحد يكون ذلك الوكيل هو الوحيد دائمًا.

كيف يُطابَق الاسم

يُطابَق رمز الإشارة بلا تفرقة بين الحرف الكبير والصغير، بتطابق تام أو ببادئة. فيصل @arch إلى وكيل اسمه architect، ويصل @Alice إلى alice.

نتيجتان يحسن التخطيط لهما:

الرمز القصير ليس خطأ. إن اشترك وكيلان في بادئة، فاز أول من يُعثَر عليه، وأيّهما ذلك يتوقف على الترتيب — لا على قاعدة لكسر التعادل. استخدم الاسم الكامل كلما تداخلت الأسماء.
لا يدخل في الرمز إلا محارف الكلمة: حروف، وأرقام، وشرطة سفلية. يطابق التحليل @(\w+)، فيُحلَّل @code-reviewer على أنه code، و@my agent على أنه my. والوكيل الذي في اسمه واصلة أو نقطة أو مسافة لا يُشار إليه بموثوقية — بما في ذلك عبر الإكمال التلقائي، الذي يدرج الاسم نصًا عاديًا. سمِّ الوكلاء بكلمة واحدة، أو بشرطات سفلية.

تُنزَع الإشارات من النص قبل أن يبلغ الوكيل. لذلك فالرسالة التي لا تضم سوى إشارات (@alice) لا تُرسِل شيئًا — أعطها عملًا.

الإشارة إلى عدة وكلاء دفعة واحدة

@alice refactor the auth module. @bob write tests for it.

يُرسَل الوكيلان بالتوازي في المحادثة نفسها، ويتلقى كل منهما الرسالة كاملة.

وهما يشتركان في أشجار عمل تلك المساحة. تُجهَّز أشجار عمل المستودعات لكل مساحة لا لكل وكيل، ويحصل كل وكيل على دليل عمل متراكب خاص به لملف AGENTS.md ومهاراته وإعداده، وتُربَط فيه المستودعات المشتركة للقراءة والكتابة. فيستطيع وكيلان أُشير إليهما معًا أن يريا تعديلات بعضهما — وأن يصطدما بها.

الإشارة إلى زميل

كل @token لا يطابق وكيلًا يُجرَّب على أعضاء مساحة العمل من البشر، بالمعرّف القصير، وبقاعدة المطابقة نفسها: بلا تفرقة بين الحرف الكبير والصغير، وبتطابق تام أو ببادئة.

الإشارة إلى إنسان بعد حلّها لا تُرسِل شيئًا. تُرفَق بالبيانات الوصفية للرسالة لغرض واحد: أن ينبّه موجّه الإشعارات ذلك الشخص.

تُجرَّب أسماء الوكلاء أولًا دائمًا، والرمز الذي يحوزه وكيل لا يُعرَض على قائمة الأعضاء — وكلمة @word واحدة لا تُحَل إلا إلى طرف واحد.

ما يتلقاه الوكيل

يحصل الوكيل المُرسَل على كتلة “Summons” في مطالبته، تسمّي من استدعاه وتسرد كشف المساحة — الوكلاء الآخرون (موسومون بـ top-level agent أو subordinate agent) والأعضاء من البشر — حتى يعرف لمن يستطيع أن يسلّم. وتخبره الكتلة أيضًا أن الإشارة إلى وكيل آخر في رده توقظ ذلك الوكيل، وأن الإشارة إلى نفسه تُتجاهَل.

حين يشير وكيل إلى وكيل

يستطيع الوكيل أن يسلّم في رده نفسه. حين تكتمل الجولة بنظافة، تُحَل الإشارات في نصه، ويُضاف أولئك الوكلاء إلى المساحة ويُرسَلون في المحادثة نفسها، وتصير الجولة التي أشارت إليهم مطالبتهم. الجولة التي فشلت أو قُطعت لا توقظ أحدًا — فقد توقفت في منتصف الفكرة.

القواعد هنا أشد عمدًا مما في حقل الكتابة، فلا أحد يراقب ليصحّح تخمينًا خاطئًا:

الأسماء المطابقة تمامًا فقط. بلا مطابقة بالبادئة. @arch يصل إلى architect حين يكتبه إنسان، ومن وكيل لا يصل إلى أحد. والاسم الذي يطابق وكيلين لا يصل إلى أحد أيضًا.
الشفرة ليست نثرًا. تُتجاهَل الإشارات داخل الكتل المسيّجة أو `backticks`، فاقتباس التعليق التوضيحي @Override أو الأمر pip install foo@1.2 آمن. والسياج الذي لا يُغلَق يُسقِط كل ما بعده.
إلصاق @ بالرمز السابق ليس إشارة — sam@host.com وpkg/@scope وnode@20 لا تُحَل إلى أحد.
الواصلات تُحفَظ، فيُحَل @code-reviewer كما هو لا على أنه الرمز code.
ثلاثة وكلاء على الأكثر في الجولة. الوكيل الذي يسرد ستة زملاء في ملخص يسردهم ولا يستدعيهم.

تُحدَّ سلسلة الإيقاظ كما يُحدَّ التفويض: عمق 3، والوكيل الموجود أصلًا على السلسلة لا يُوقَظ بها مرة أخرى (لا A → B → A). والزوج المرتّب يخضع لحد المعدّل عبر السلاسل أيضًا. الإيقاظ المرفوض يكتب رسالة نظام في المحادثة تسمّي الإشارة التي لم تُسلَّم وسبب ذلك — والاسم الذي لم يُحَل لا يفعل ذلك، وإلا روت كل @ في الجملة عن نفسها.

للتسليم الذي يجب ألا يعتمد على النثر — طلب وردّ، أو بلوغ وكيل خارج المساحة — استخدم أدوات send_to_agent وask_agent وdelegate_task.

أدلة ذات صلة

مفاهيم ذات صلة

دورة حياة إرسال الوكيل