أنهى الوكيل الجزء الأكبر من التغيير الخاص بك. الآن، ترغب في فحص تفصيل تنفيذي واحد، وتعديل بضعة أسطر يدوياً، وتشغيل المشروع محلياً قبل نشره. لكن العمل موجود في تطبيق GitHub Copilot… ومحررك هو المكان الذي تراجع فيه الفروقات، وتصحح الأخطاء البرمجية، وتجري التعديلات النهائية. هل يجب عليك الاختيار بين البقاء في الجلسة والبدء من جديد في Visual Studio Code؟ لا يجب عليك ذلك. يمكنك فتح جلسة تطبيق Copilot مباشرة في VS Code ومتابعة محادثتها وتغييراتها البرمجية وسياق عملها سليمة. هذا يعني أن Copilot يمكنه التعامل مع العمل المتكرر أو المستهلك للوقت، ثم يعيد التحكم إليك للمراجعة الدقيقة والتحرير اليدوي والاختبار المحلي.
في هذا الدليل التعليمي، ستتعلم كيفية:
- فتح جلسة تطبيق Copilot في VS Code.
- مراجعة تغييرات الوكيل سطراً بسطر.
- متابعة نفس المحادثة من محرر التعليمات البرمجية الخاص بك.
- تعديل واختبار التعليمات البرمجية محلياً.
- دفع تحديثاتك إلى طلب السحب المرتبط بالجلسة.
كيف تبدأ جلسة في تطبيق Copilot؟
افتح الجلسة التي ترغب في متابعتها. قبل تسليمها، خصص لحظة لمراجعة المهمة والعمل الذي أنجزه Copilot. تحتوي الجلسة على أكثر من مجرد مجموعة من الملفات المعدلة. كما أنها تسجل المهمة والخطة والمحادثة التي أنتجت تلك التغييرات. هذا السياق مهم عندما ترغب في فهم سبب اختيار Copilot لتنفيذ معين أو تطلب منه مراجعة جزء من العمل. لا تحتاج إلى تلخيص هذا التاريخ أو نسخه إلى محادثة جديدة قبل الانتقال إلى VS Code.
كيف تفتح الجلسة في VS Code؟
إذا عرض التطبيق أكثر من محرر مدعوم أو تثبيت لـ VS Code، فاختر الذي ترغب في استخدامه. يفتح VS Code المشروع باستخدام شجرة العمل (worktree) المرتبطة بالجلسة. كما يعرض الجلسة الحالية في الشريط الجانبي لـ Copilot. هذا يمنحك ثلاثة أجزاء متصلة من العمل الأصلي:
أنت تتابع الجلسة الحالية، ولا تعيد بناءها في نافذة محرر جديدة.
- سياق الجلسة: تظل المهمة والخطة والمحادثة متاحة.
- الفروقات (diff): الملفات والأسطر التي غيرها الوكيل جاهزة للمراجعة.
- شجرة العمل (worktree): يفتح VS Code نفس شجرة العمل المعزولة التي استخدمتها الجلسة.
كيف تراجع تغييرات الوكيل؟
قبل التحرير، افحص الفروقات (diff) في VS Code. افتح عرض التحكم بالمصدر (Source Control) لرؤية الملفات التي تم تغييرها، ثم حدد ملفاً لمراجعة تغييراته سطراً بسطر. راجع التنفيذ كما تفعل مع أي تغيير مقترح آخر. على وجه الخصوص، تحقق مما يلي:
يمكن للمحادثة المحفوظة أن تساعد في شرح كيف توصل Copilot إلى هذا التنفيذ. إذا كان هناك شيء غير واضح، استمر في توجيه Copilot في الشريط الجانبي. على سبيل المثال: اشرح لماذا غيرت هذه الدالة بدلاً من إضافة دالة مساعدة جديدة. حدد أي سلوك قد يؤثر عليه هذا. يمكنك أيضاً أن تطلب من Copilot إجراء تغيير آخر. نظراً لأن الجلسة وشجرة العمل تظلان متصلتين، لا يتعين عليك وصف المهمة من البداية.
- أن التعليمات البرمجية تحل المشكلة المطلوبة.
- أن التنفيذ يتبع اتفاقيات المستودع.
- أن حالات الأخطاء والحالات الهامشية (edge cases) تُعالج بشكل مناسب.
- أن الاختبارات تغطي السلوك الذي تغير.
- أنه لم يتم تعديل أي ملفات أو سلوكيات غير ذات صلة.
كيف تجري تعديلاً يدوياً؟
بمجرد فهمك للتغييرات المقترحة، قم بتحرير أي ملف مباشرة في VS Code. هذا مفيد للتعديلات الأسرع أو الأسهل يدوياً، مثل:
أنت تقوم بتحرير شجرة العمل الحالية للجلسة، لذا فإن تغييراتك اليدوية تبنى مباشرة على عمل الوكيل. لا تحتاج إلى نسخ الملفات بين الدلائل أو إعادة إنشاء الفرع يدوياً.
- تحسين تسمية أو رسالة خطأ.
- إعادة تسمية متغير للوضوح.
- تعديل التخطيط أو الأنماط.
- إضافة حالة اختبار مفقودة.
- تطبيق اتفاقية خاصة بالمستودع.
كيف تشغل المشروع وتتحقق منه محلياً؟
استخدم الطرفية المدمجة في VS Code لتشغيل سير عمل التحقق العادي للمشروع. تعتمد الأوامر الدقيقة على المستودع، ولكن بعض أمثلة تطبيقات الويب قد تتضمن:
تعامل مع التغييرات التي أنشأها الوكيل بنفس الطريقة التي تتعامل بها مع التعليمات البرمجية التي كتبها شخص: قم بتشغيل الاختبارات ذات الصلة، وافحص الإخفاقات، وتحقق من السلوك بنفسك. إذا طبع خادم التطوير عنوان URL محلياً (localhost URL)، فافتحه لاختبار التغيير في المتصفح. عندما يدعم إعداد VS Code الخاص بك ذلك، يمكنك فتح عنوان URL في المتصفح المدمج في VS Code وفحص النتيجة دون مغادرة المحرر. بالنسبة لتغيير واجهة المستخدم، تحقق من السلوك المطلوب والحالات المجاورة. على سبيل المثال، تحقق من المكون المعدل بأحجام عرض مختلفة وتأكد من أن حالات التحميل والفارغة والخطأ لا تزال تعمل.
- npm install
- npm test
- npm run lint
- npm run dev
كيف تواصل العمل مع Copilot أو التحرير بنفسك؟
في أي وقت، يمكنك اختيار التفاعل الذي يناسب الخطوة التالية بشكل أفضل:
على سبيل المثال، بعد إجراء تعديل يدوي لواجهة المستخدم، قد تسأل Copilot: أضف اختباراً للتسمية المحدثة وقم بتشغيل ملف الاختبار ذي الصلة. لا تعدل المكونات غير ذات الصلة.
- وجه Copilot عندما يتطلب التغيير تحليلاً على مستوى المستودع أو تعديلات متكررة.
- حرر مباشرة عندما تعرف التغيير الدقيق الذي تريده.
- استخدم كلا النهجين بشكل متكرر أثناء اختبارك وتحسينك للتنفيذ.
كيف تلتزم بالتغييرات المكتملة وتدفعها؟
عندما يصبح التنفيذ جاهزاً، راجع الفروقات النهائية مرة أخرى. ثم التزم بالتغييرات وادفعها باستخدام عرض التحكم بالمصدر (Source Control) أو الطرفية المدمجة:
- git status
- git add
استخدم ممارسات الفرع والالتزام والمراجعة والموافقة العادية لمستودعك. نظراً لأن VS Code فتح شجرة العمل والفرع المرتبطين بالجلسة، فإن دفع الفرع يحدث طلب السحب الذي يتتبع هذا العمل بالفعل. لا توجد حاجة لنسخ الملفات المكتملة إلى نسخة أخرى أو إعادة ربط العمل بطلب السحب يدوياً.
- git push
سير عمل مستمر من الوكيل إلى المحرر يمنحك فتح جلسة تطبيق Copilot في VS Code تقسيم عمل واضحاً دون تقسيم العمل نفسه. يمكن لـ Copilot أن يتولى تنفيذاً أكبر أو متكرراً، بينما يمكنك الانتقال إلى المحرر للمراجعة التفصيلية والتغييرات المستهدفة والاختبار المحلي واللمسات النهائية. تنتقل الجلسة والفروقات وشجرة العمل معك. ابدأ بتوجيه العمل في تطبيق Copilot، وانتقل إلى VS Code متى أردت التحكم اليدوي، وادفع النتيجة النهائية عبر نفس سير عمل طلب السحب.
جرّب الأداة: فاحص الفروقات بين النصوص
