الوكلاء الفرعيون والمهام في الخلفية والحلقات
يمكن للوكيل تقسيم طلب كبير إلى أجزاء، وتشغيلها بالتوازي، و مواصلة العمل في الخلفية بينما تواصل أنت عملك. كل ما هو موصوف هنا يعمل داخل جلسة المحطة الطرفية الخاصة بك ويتوقف عند انتهاء الجلسة.
الوكلاء الفرعيون
Section titled “الوكلاء الفرعيون”الوكيل الفرعي هو وكيل منفصل له سياقه الخاص الجديد، وتعليماته، و قائمة أدواته. تقوم Eve بتشغيل الوكلاء الفرعيين عندما تستفيد المهمة من التوازي، على سبيل المثال للبحث في وحدات متعددة من قاعدة كود كبيرة، أو تشغيل اختبارات الأداء، أو تنفيذ عمليات إعادة هيكلة مستقلة في وقت واحد. لا يتم إرجاع سوى الإجابة النهائية للوكيل الفرعي إلى المحادثة الرئيسية، مما يحافظ على نافذة السياق الأساسية موجزة.
- تعمل الوكلاء الفرعيون بالتوازي، بحد أقصى 32 في المرة الواحدة بشكل افتراضي. يمكن لـ Eve تشغيل مجموعات من المهام المتوازية في دورة واحدة لتحقيق أقصى إنتاجية.
- يمكن للوكيل الفرعي تشغيل وكلاء فرعيين خاصين به، بعمق يصل إلى مستويين.
- لا تحصل الوكلاء الفرعيون أبدًا على أذونات أكثر من تلك الممنوحة لجلستك. تظهر مطالبات الأذونات الخاصة بهم في محطتك الطرفية، مصحوبة باسم الوكيل الفرعي، واحدة تلو الأخرى .
- يتم دعم سير العمل الذي يستغرق عدة ساعات وتعليق الأدوار المعقدة حتى 2,000 دورة دور.
- كل دور للوكيل الفرعي يُعتبر دورًا عاديًا للوكيل ويُحتسب ضمن حدودك.
الوكلاء المدمجون
Section titled “الوكلاء المدمجون”| الوكيل | الأدوات | استخدم |
|---|---|---|
general | كل أداةCHAMPREP محلية وأداة متوفرة في الجلسة | أجزاء قائمة بذاتها من مهمة أكبر. |
explore | الأدوات المحلية للقراءة فقط | بحث سريع في قاعدة الكود يعرض النتائج. |
plan | للقراءة فقط | خطة تنفيذ خطوة بخطوة. |
review | للقراءة فقط، بالإضافة إلى القراءة فقط git | مراجعة طلب مقارنة أو فرع أو دمج. |
platform | CHAMPREP الأدوات فقط؛ لا توجد ملفات أو أوامر محلية | Work عبر CHAMPREPخدماتك. |
قم بتشغيل الوكيل بنفسك
Section titled “قم بتشغيل الوكيل بنفسك”/agents/agents run explore where is the invoice total calculated?@explore where is the invoice total calculated?@agent-name prompt يُشغّل الوكيل كمهمة في الخلفية ويُبلغ عن نتائجه عند الانتهاء. قم بإنشاء وكلاء خاصين بك باستخدام /agents create NAME؛ انظر الوكلاء المخصصون.
قائمة المهام
Section titled “قائمة المهام”بالنسبة للطلبات متعددة الخطوات، يحتفظ Eve بقائمة مهام حية تضم العناصر المعلقة، والجاري تنفيذها، والمكتملة. اضغط على Ctrl+T لإظهاره أو إخفائه، أو لتشغيله /todos.
أوامر shell والعمليات في الخلفية
Section titled “أوامر shell والعمليات في الخلفية”يمكن لـ Eve تشغيل الأوامر التي تستغرق وقتًا طويلاً، مثل خادم التطوير، أو مراقب الملفات، أو المُجمِّع، أو مجموعات الاختبارات الطويلة، في شل يعمل في الخلفية مع الاستمرار في العمل. وهو يراقب المخرجات بشكل غير متزامن ويمكنه انتظار أنماط مثل
server listening أو FAIL قبل المتابعة.
- يمكن تشغيل ما يصل إلى 64 شل في الخلفية في وقت واحد.
- يتم تتبع النشاط الجاري في الخلفية على سطر الحالة (على سبيل المثال
🐚 2 shells) وتشغيل ملخص الحالة (⚡ 2 shell(s), 3 agent(s) active). - استخدم
/shellsأو/procsلفتح أداة فحص الأوامر المخصصة التي تعرض معرّفات العمليات (PIDs) وخطوط الأوامر ورموز الخروج ومقاطع المخرجات.
الحلقات
Section titled “الحلقات”تشغيل موجه بشكل متكرر في الجلسة الحالية:
/loop 5m check whether the deploy finished and summarise any errors/loop --max 10 30m run the test suite and fix new failures/loop keep improving test coverage for src/billing/loop stop- مع وجود فاصل زمني بين
30sو24h، يتم تشغيل الموجه وفقًا لذلك الجدول الزمني. - بدون تحديد فترة زمنية، تكون الحلقة ذاتية التوقيت: يحدد الوكيل متى يتم التشغيل المرة التالية، في غضون دقيقة واحدة إلى ساعة واحدة لاحقًا.
- تتوقف الحلقة بعد 50 عملية تشغيل افتراضيًا؛ قم بتغيير هذا باستخدام
--max N. كما يتوقف عند/loop stop [id]أو عند الخروج.
كل عملية تشغيل تمثل دورًا عاديًّا: فهي تستخدم حدودك وتطلب الإذن مثل أي دور آخر.
/tasks و /shells
Section titled “/tasks و /shells”/tasks يسرد كل ما يتم تشغيله في الخلفية — الوكلاء الفرعيون، و أوامر shell في الخلفية، والحلقات — مع الوقت المنقضي.
/shells (أو /procs) يركز بشكل خاص على عمليات شل النشطة والمكتملة.
/tasks/tasks tail ID/tasks attach ID/tasks stop ID/tasks stop all
/shells/procsيعرض سطر الحالة عدد المهام وبيئات العمل النشطة. /exit يحذرك قبل المغادرة بينما لا تزال العمليات أو المهام في الخلفية قيد التشغيل.
تعد المهام الخلفية، والوكلاء الفرعيون، وعدد الوكلاء الفرعيين المتوازيين من ميزات الخطة . انظر الخطط والحدود.
أشجار العمل
Section titled “أشجار العمل”تمنح شجرة عمل git الجلسة عملية سحب خاصة بها، لذا لا تقوم الجلسات المتوازية أو الوكلاء الفرعيون بتحرير نفس الملفات أبدًا.
champrep ai --worktreechamprep ai --worktree fix-rounding/worktree fix-rounding/worktree exitيتم إنشاء شجرة العمل تحت .champrep/worktrees/NAME في فرع جديد
ai/NAME. عند الخروج، تتم إزالة شجرة العمل التي لا تحتوي على تغييرات؛ بينما يتم الاحتفاظ بشجرة العمل التي تحتوي على تغييرات والإبلاغ عنها حتى تتمكن من تثبيتها أو تجاهلها. يمكن للوكيل المخصص أيضًا تعيين isolation: worktree للعمل دائمًا في شجرة العمل الخاصة به.
المراجعات
Section titled “المراجعات”/review/review main/review !42/security-review- بدون أي وسيطة،
/reviewيستعرض التغييرات غير الملتزم بها والمُعدة للتنفيذ. - مع وجود فرع أو مرجع، يقوم بمقارنة ذلك الفرع مع الفرع الحالي
HEAD. - مع
!NUMBERأو رابط طلب دمج، فإنه يراجع طلب دمج الكودCHAMPREP من خلال CHAMPREPأدواتك.
/security-review يبحث عن المشكلات القابلة للاستغلال مثل الحقن، ثغرات التفويض، والأسرار المكشوفة، واختراق المسار. يعمل كلا الأمرين على تشغيل الوكيل للقراءة فقط review الوكيل ويقدم تقريرًا بالنتائج مرتبة حسب درجة الخطورة مع الإشارة إلى الملف و السطر.