تخطَّ إلى المحتوى
Documentation

الوكلاء الفرعيون والمهام في الخلفية والحلقات

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

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

  • تعمل الوكلاء الفرعيون بالتوازي، بحد أقصى 32 في المرة الواحدة بشكل افتراضي. يمكن لـ Eve تشغيل مجموعات من المهام المتوازية في دورة واحدة لتحقيق أقصى إنتاجية.
  • يمكن للوكيل الفرعي تشغيل وكلاء فرعيين خاصين به، بعمق يصل إلى مستويين.
  • لا تحصل الوكلاء الفرعيون أبدًا على أذونات أكثر من تلك الممنوحة لجلستك. تظهر مطالبات الأذونات الخاصة بهم في محطتك الطرفية، مصحوبة باسم الوكيل الفرعي، واحدة تلو الأخرى .
  • يتم دعم سير العمل الذي يستغرق عدة ساعات وتعليق الأدوار المعقدة حتى 2,000 دورة دور.
  • كل دور للوكيل الفرعي يُعتبر دورًا عاديًا للوكيل ويُحتسب ضمن حدودك.

الوكيلالأدواتاستخدم
generalكل أداةCHAMPREP محلية وأداة متوفرة في الجلسةأجزاء قائمة بذاتها من مهمة أكبر.
exploreالأدوات المحلية للقراءة فقطبحث سريع في قاعدة الكود يعرض النتائج.
planللقراءة فقطخطة تنفيذ خطوة بخطوة.
reviewللقراءة فقط، بالإضافة إلى القراءة فقط gitمراجعة طلب مقارنة أو فرع أو دمج.
platformCHAMPREP الأدوات فقط؛ لا توجد ملفات أو أوامر محليةWork عبر CHAMPREPخدماتك.

/agents
/agents run explore where is the invoice total calculated?
@explore where is the invoice total calculated?

@agent-name prompt يُشغّل الوكيل كمهمة في الخلفية ويُبلغ عن نتائجه عند الانتهاء. قم بإنشاء وكلاء خاصين بك باستخدام /agents create NAME؛ انظر الوكلاء المخصصون.

بالنسبة للطلبات متعددة الخطوات، يحتفظ 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) وخطوط الأوامر ورموز الخروج ومقاطع المخرجات.

تشغيل موجه بشكل متكرر في الجلسة الحالية:

/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 يسرد كل ما يتم تشغيله في الخلفية — الوكلاء الفرعيون، و أوامر shell في الخلفية، والحلقات — مع الوقت المنقضي. /shells (أو /procs) يركز بشكل خاص على عمليات شل النشطة والمكتملة.

/tasks
/tasks tail ID
/tasks attach ID
/tasks stop ID
/tasks stop all
/shells
/procs

يعرض سطر الحالة عدد المهام وبيئات العمل النشطة. /exit يحذرك قبل المغادرة بينما لا تزال العمليات أو المهام في الخلفية قيد التشغيل.

تعد المهام الخلفية، والوكلاء الفرعيون، وعدد الوكلاء الفرعيين المتوازيين من ميزات الخطة . انظر الخطط والحدود.

تمنح شجرة عمل git الجلسة عملية سحب خاصة بها، لذا لا تقوم الجلسات المتوازية أو الوكلاء الفرعيون بتحرير نفس الملفات أبدًا.

Terminal window
champrep ai --worktree
champrep ai --worktree fix-rounding
/worktree fix-rounding
/worktree exit

يتم إنشاء شجرة العمل تحت .champrep/worktrees/NAME في فرع جديد ai/NAME. عند الخروج، تتم إزالة شجرة العمل التي لا تحتوي على تغييرات؛ بينما يتم الاحتفاظ بشجرة العمل التي تحتوي على تغييرات والإبلاغ عنها حتى تتمكن من تثبيتها أو تجاهلها. يمكن للوكيل المخصص أيضًا تعيين isolation: worktree للعمل دائمًا في شجرة العمل الخاصة به.

/review
/review main
/review !42
/security-review
  • بدون أي وسيطة، /review يستعرض التغييرات غير الملتزم بها والمُعدة للتنفيذ.
  • مع وجود فرع أو مرجع، يقوم بمقارنة ذلك الفرع مع الفرع الحالي HEAD.
  • مع !NUMBER أو رابط طلب دمج، فإنه يراجع طلب دمج الكودCHAMPREP من خلال CHAMPREPأدواتك.

/security-review يبحث عن المشكلات القابلة للاستغلال مثل الحقن، ثغرات التفويض، والأسرار المكشوفة، واختراق المسار. يعمل كلا الأمرين على تشغيل الوكيل للقراءة فقط review الوكيل ويقدم تقريرًا بالنتائج مرتبة حسب درجة الخطورة مع الإشارة إلى الملف و السطر.