قبل أن تبدأ
يستخدم هذا الدليل مثال Twitter، twitter-starter، لبناء ميزة: مشاركة إيموجي عملاق مع نص أسفله. ستشرح ما تريده مباشرةً للوكيل، وتتابع عمله، وتراجع النتيجة النهائية. يمكنك تطبيق سير العمل نفسه على ميزة أخرى أو على خطأ تريد إصلاحه.
- ثبّت Panolayer، وسجّل الدخول، وافتح مثال Twitter Clone. راجع تثبيت Panolayer وإعداده إن لم تكن قد فتحت مستودعًا بعد.
- استخدم Panolayer Agent المدمج. يمكنك أيضًا استخدام أي وكيل آخر مدعوم، لكن عليك تثبيته قبل استخدامه. راجع الوكلاء المدعومون للإعداد.
ستنتهي بتغيير تمت مراجعته ومسجّل في سجل Git المحلي لديك. دفع التغيير إلى مستودع بعيد خطوة منفصلة.
ابدأ Panolayer Agent
- افتح وكلائي في الشريط الجانبي.
- انقر زر + بجوار مراقبة الوكلاء لفتح قائمة الوكلاء.
- اختر Panolayer Agent لهذا الشرح.
تتضمن القائمة Panolayer Agent والوكلاء الذين ثبّتتهم. يمكنك اختيار أي منها لإصلاح خطأ أو بناء شيفرة.
يعمل Panolayer Agent مثل وكلاء البرمجة الذين تستخدمهم بالفعل. اطلب منه بناء ميزة أو إصلاح خطأ أو الإجابة عن سؤال حول شيفرتك. اكتب طلبك في تحدّث مع قاعدة شيفرتك أو ابنِ شيئًا… وتابع المحادثة أثناء عملك.
هل تبدأ من مشكلة؟ في المشكلات، اختر إصلاح وحدد Panolayer Agent. ينقل Panolayer سياق المشكلة إلى المهمة. اتبع جولة إصلاح أول خطأ لهذا المسار.
أعطِه مهمة بنتيجة واضحة
صِف ما المشكلة أو ما تريد بناءه، وما الذي ينبغي أن يحدث عند نجاحه، وأي شيء ينبغي أن يحافظ عليه الوكيل. اذكر اسم ملف أو دالة عندما تعرفها.
لمثال Twitter، استخدم الطلب نفسه الظاهر في لقطة الشاشة:
أضف ميزة جديدة حيث يمكنك مشاركة إيموجي عملاق مع نص أسفله
أدخل طلبك في مربع الرسالة، ثم انقر على سهم الإرسال.
يمكن لـ Panolayer Agent استخدام خريطة الشيفرة للعثور على الدوال والعلاقات ذات الصلة أثناء عمله. يمكنك الإشارة إلى السلوك الذي يهمك حتى عندما لا تعرف كل اسم ملف.
إذا طرح الوكيل سؤالاً، فأجب عنه في المحادثة نفسها. إذا احتجت إلى تضييق المهمة، فحدد النتيجة المحددة التي تريدها.
تابع العمل دون التخلي عن مساحة عملك
عندما يبدأ Panolayer Agent تشغيلاً برمجياً، يظهر تقدمه في المحادثة. يتم عمل البرمجة في شجرة عمل Git معزولة: نسخة سحب منفصلة حيث يمكن للوكيل تحرير الشيفرة واختبارها بينما تبقى مساحة عملك الرئيسية متاحة.
تابع المهمة في المحادثة
تعرض بطاقة التشغيل المهمة ونشاطها الحالي بينما يبني الوكيل ميزة الإيموجي العملاق. يمكنك متابعة تقدمه ورؤية الملفات والأوامر التي يستخدمها أثناء عمله.
افتح التشغيل لمزيد من التفاصيل
اختر فتح على الجانب الأيمن من البطاقة لرؤية نشاط التشغيل. في البث، حدد نشاطاً لفحص الأمر ومخرجاته في اللوحة اليمنى. استخدم العودة إلى الوكيل للعودة إلى المحادثة.
اعرف متى يكتمل التشغيل
عندما ينتهي العمل، تُحدَّث البطاقة إلى اكتمل تشغيل الوكيل الفرعي. يلخص شريط تم عمليات التحقق وعدد الملفات المتغيرة. لا يزال بإمكانك اختيار فتح لفحص التشغيل المكتمل.
يمكنك مواصلة العمل والعودة إلى التشغيل لاحقاً. استخدم مراقبة الوكلاء للحصول على نظرة عامة عندما يكون لديك أكثر من وكيل يعمل. يمكن لعدة وكلاء العمل على المستودع نفسه في أشجار عمل منفصلة؛ راجع كيف تتلاءم تغييراتهم معاً قبل دمجها.
أبقِ المتابعة مرتبطة بمهمتها. استخدم مرجع التشغيل الظاهر في محادثتك عند إرسال متابعة، حتى يتضح أي مهمة تقصد.
راجع نتيجة التحقق
راجع الكود المُعدَّل إلى جانب نتيجة التحقق قبل الدمج. اطّلع على مراجعة التغييرات والإيداع للحصول على الدليل الكامل لمراجعة تغييرات الوكيل.
عندما يطلب الوكيل الدمج، اقرأ ملخّص التحقق: القواعد الناجحة، وعمليات التحقق، والملفات المتغيّرة. راجع أي إخفاقات جديدة بشكل منفصل عن المشكلات الموجودة مسبقًا.
في هذه العملية، يعرض الملخّص نجاح 110 من 121 قاعدة، وعملية تحقق واحدة، و16 ملفًا متغيّرًا. ويحدّد 11 إخفاقًا موجودًا مسبقًا بشكل منفصل، ولا يُبلّغ عن أي إخفاقات أو تحذيرات أو قواعد غير مفحوصة جديدة. تعتمد مجاميعك على مهمتك.
افتح التفاصيل لفحص النتيجة بمزيد من العمق. راجع فهم نتيجة التحقق للاطّلاع على حقول الملخّص وحالاته.
تحقّق من السلوك في التطبيق قيد التشغيل عندما تتطلب المهمة ذلك. في هذا المثال، جرّب إنشاء منشور بإيموجي عملاق ونص أسفله، ثم تحقّق من أن المنشورات النصية العادية لا تزال تعمل كما هو متوقع.
Merge when you’re ready
You decide what moves from the agent’s worktree into your branch. Choose Not now to keep reviewing. Once you’re satisfied with the changes and results, confirm the target branch and choose Merge into main for the Twitter sample.
The Merged into main confirmation shows a commit ID. This workflow records the change in local Git history, so you don’t need to commit that same change again.
Open Changes and find the commit in History. Check for unexpected uncommitted edits. If your repository has a remote and you want to share the commit, use Git → Push.
You’ve given an agent a task, followed its work, reviewed the result, and decided what reaches your branch.