AI CodeOps

كيف يعمل AI CodeOps

آخر تحديث

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

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

1. تصف أنت المهمة

افتح Develop → AI Sessions واختر New session (جلسة جديدة). صف المهمة، واختر سير العمل في Workflow والمشروع في Project، ثم اختر Start session (بدء الجلسة). كل جلسة تتبع مشروعا.

قبل أن يعمل أي شيء، يفحص AI CodeOps أمرين:

  • ميزانيتك. إذا تجاوزت مساحة العمل ميزانيتها أو نفدت حصتها، لا تبدأ الجلسة وتذكر السبب. راجع ضوابط التكلفة.
  • سياسة مساحة عملك. قاعدة الرفض (deny) توقف الجلسة. وقاعدة طلب الموافقة (ask) تحتجزها إلى أن يوافق عليها أحد في Review & Gate → Approvals. راجع الموافقات والسياسات.

ثم توضع الجلسة في قائمة الانتظار بالحالة pending إلى أن يلتقطها عامل تشغيل.

2. يعمل الوكلاء عبر سير العمل

سير العمل قائمة ثابتة من الخطوات. يشغل كل خطوة وكيل واحد، وتعمل الخطوات واحدة تلو الأخرى. وسير العمل الافتراضي، وهو Plan, Build, Review & Test، فيه أربع خطوات:

  1. خطوة Plan، ينفذها Architect.
  2. خطوة Build، ينفذها Builder.
  3. خطوة Review، ينفذها Reviewer.
  4. خطوة Test، ينفذها Tester.

الخطوات حتى الخطوة المنفذة للتغيير (وهي هنا Plan و Build) تعمل أولا. والخطوات التي بعدها تفحص العمل، فتنتظر إلى أن يكتب الكود وتعمل اختباراتك عليه (المرحلة 5).

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

3. يكتب التغيير

ثم يحول AI CodeOps الخطة إلى ملفات كاملة. يطبقها على نسخة جديدة من مستودعك وينتج الفروقات. والمشروع الذي لا مستودع له يحصل على قاعدة كود جديدة بدلا من ذلك.

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

الفروقات التي تتجاوز 60 KB ترفض كلها برسالة "Split the task into smaller changes." وإذا لم تعد أي تغييرات ملفات صالحة للاستخدام، تفشل الجلسة مع ذكر السبب.

4. تعمل اختباراتك

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

أمر الاختبار هو المضبوط على المشروع. ومن دونه، يبحث AI CodeOps عن سكربت test في package.json، ثم عن pytest، ثم عن go test. وإذا تعذر تشغيل الاختبارات كليا (لا أمر، أو تبعيات لا تثبت)، لا يسجل شيء وتبين صفحة التشغيل أن التغيير لم يجر التحقق منه. وبوابة الإصدار لا تحتسب ذلك نجاحا: ترفض تغيير كود بلا نتيجة اختبار، ما لم يكن خيار Don't run tests for this project مفعلا في المشروع.

5. تفحص الخطوات الباقية التغيير المكتوب

الخطوات التي تلي خطوة التنفيذ (وهي هنا Review و Test) تعمل الآن. يعرض على كل منها التغيير كما كتب ونتيجة الاختبار المسجلة، ويطلب منها أن تذكر الملفات التي قرأتها. ويأتي ملخص الجلسة من آخر هذه الخطوات، فيكون مكتوبا بعد تشغيل الاختبارات.

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

6. تراجع الفروقات

تقرأ جولة مراجعة الفروقات الفعلية، ومعها ملاحظات خطوتي المراجعة والأمان سياقا. وتسجل الملاحظات (findings)، ولكل منها درجة خطورة وتصنيف وملف في العادة. وفي جلسة المتابعة، تخبر أيضا بما أثارته الجولات السابقة وبما قرره شخص في كل منها. راجع المراجعات متعددة الوكلاء.

وإذا تعذر إتمام تلك المراجعة، يحتجز التغيير: فملاحظاته مجهولة، ولا يمكن معاملته على أنه سليم.

7. ينتظر التغيير شخصا

حين تنتهي الجلسة بفروقات، فإن AI CodeOps:

  • يسم الجلسة بالحالة completed؛
  • ينقل تغييرها إلى الحالة in review في Develop → Changes؛
  • يفتح طلب مراجعة في Review & Gate → Approvals. وتنتهي صلاحيته بعد 7 أيام.

افتح صفحة الجلسة لترى الملخص، وقسم Proposed changes، ولوحة Quality gates، وقسم Findings.

8. يوافق شخص

اختر Accept changes (قبول التغييرات) في صفحة الجلسة، أو Approve (موافقة) في صفحة Approvals. ومن بدأ الجلسة لا يستطيع الموافقة عليها ما دام في مساحة العمل شخص آخر يستطيع ذلك. ومساحة العمل ذات الشخص الواحد تستطيع الموافقة على تغييرها. ورفض واحد ينهي الطلب.

9. يفتح طلب السحب

الموافقة تبدأ طلب السحب. وقبل فتحه، يفحص AI CodeOps بالترتيب:

  1. سياسة مساحة العمل؛
  2. الموافقة؛
  3. بوابة الجودة: لا ملاحظات مفتوحة بخطورة high أو critical، ولا اختبارات فاشلة، ومراجعة مكتملة.

إذا نجحت الثلاثة، يدفع AI CodeOps فرعا اسمه codeops/run-<id> ويفتح طلب سحب إلى الفرع الافتراضي للمشروع. ويستخدم اتصال Git الخاص بمن وافق، فيحتاج ذلك الشخص إلى حساب Git مربوط لتلك الخدمة. وإذا تعذر فتح طلب السحب، اختر Create Pull Request في صفحة الجلسة. ويبين الزر ما ينقص.

10. الدمج والنشر

ادمج طلب السحب حين تكون مستعدا. وإذا دمجته من لوحة التحكم، تفحص بوابة الجودة مرة أخرى أولا. وإذا كانت للمشروع وجهة نشر، يستدعي AI CodeOps بعدها عنوان webhook للنشر لديك ويسجل عملية النشر. راجع النشر عبر البوابات.

الحدود الزمنية

المرحلةالحد
الخطوات قبل الكود4 دقائق في المجموع
كتابة التغيير8 دقائق
الاختبارات6 دقائق، إضافة إلى الأمر الجاري تنفيذه
الخطوات بعد الكود3 دقائق في المجموع
مراجعة الفروقاتدقيقتان (2)
الجلسة كلهاتوقف بوصفها عالقة بعد نحو 30 دقيقة

الجلسة التي تنتهي مهلتها أو تعلق تنتهي بالحالة failed، مع ذكر السبب في صفحتها.

الخطوات التالية

الأسئلة الشائعة

هل تدمج جلسة الذكاء الاصطناعي الكود من تلقاء نفسها؟

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

ماذا لو لم يكن في مشروعي اختبارات؟

تعمل الجلسة مع ذلك، وتبين صفحة التشغيل أن التحقق جرى تخطيه. ثم ترفض بوابة الإصدار التغيير، لأن تغيير الكود بلا نتيجة اختبار ليس نجاحا. وإذا لم تكن للمشروع مجموعة اختبارات، ففعّل خيار "Don't run tests for this project" في إعداداته.

هل يمكنني مشاهدة الوكلاء وهم يعملون؟

نعم. تتحدث صفحة الجلسة مباشرة مع كل خطوة، ووكيلها، وحالتها، والرموز والتكلفة حتى تلك اللحظة.

هل كانت هذه الصفحة مفيدة؟