وكلاء ذكاء اصطناعي يكتبون تغييرات الكود على مستودعك الفعلي
وكلاء AI CodeOps يحولون الخطة إلى فروقات git فعلية على مستودعك، تكتب في نسخة مستنسخة مؤقتة لا تنفذ أبدا، ثم تختبر وتراجع.
في AI CodeOps، تحول مرحلة البناء خطة الجلسة إلى تغيير فعلي في الكود: المحتوى الجديد لكل ملف تمسه، مكتوبا في نسخة مستنسخة مؤقتة من مستودعك وملتقطا في صورة فروقات git. وهذه الفروقات هي ما تعمل عليه الاختبارات، وما يقرؤه المراجعون، وما يصل في صورة طلب سحب بعد الموافقة عليه.
يجري البناء على المنصة، ضمن جلسة متصفحك. ولا شيء يحتاج إلى تثبيت. تنشأ النسخة المستنسخة باتصال git الخاص بمن بدأ الجلسة، وتحذف بعد أخذ الفروقات. ولا ينفذ كود المستودع على خوادم المنصة أبدا في هذه الخطوة. فتشغيل الكود مهمة مرحلة الاختبار، التي تستخدم بيئة معزولة.
الوكلاء الذين يعملون
وكلاء التنفيذ يصفون التغيير ملفا ملفا، مع الكود الأساسي والأسباب:
- وكيل Builder: المنفذ العام. يعمل في Plan, Build, Review & Test و Security-Sensitive Change و UI Implementation و Incident Response و Performance Tuning و Quality-Gated Change.
- الوكيلان Backend Engineer و Frontend Engineer: العمل من جهة الخادم ومن جهة العميل في Feature SDLC.
- الوكيلان Database Engineer و Migration Specialist: تصميم المخطط (schema) وعمليات الترحيل في Data Migration، والترقيات في Dependency Refresh.
- وكيل DevOps Engineer: خطوة Apply في DevOps Change.
هذه الخطوات تعيد نصا. وبعد آخرها في سير العمل، تشغل الجلسة جولة كتابة الكود (code pass) منفصلة. تقرأ المهمة وسياق المستودع وما كتبه الفريق حتى الآن، وتعيد المحتوى الجديد الكامل لكل ملف تغيره. تكتب المنصة تلك الملفات في النسخة المستنسخة وتأخذ الفروقات. فما تراجعه هو الفروقات، لا وصف Builder.
أما الخطوات التي تأتي بعد خطوة التنفيذ، مثل Review و Audit diff و Test، فلا تعمل قبل جولة كتابة الكود. تعمل بعد كتابة الكود وتشغيل اختباراتك، وتعرض عليها الفروقات ونتيجة الاختبار المسجلة.
مع فئة النماذج Auto، تذهب جولة كتابة الكود أولا إلى نموذج برمجة متوسط المستوى (Standard)، بينما تستخدم خطوات التخطيط والمراجعة أفضل فئة لديك حصة فيها. راجع النماذج.

عرض توضيحي تفاعلي، ببيانات نموذجية.
كيف يبدو التغيير
يجب أن تجيب جولة كتابة الكود بمصفوفة JSON من ملفات كاملة. وهذه هي الصيغة التي تطلبها المنصة من النموذج وتحللها:
[
{
"path": "src/checkout/CouponField.tsx",
"content": "import { useState } from \"react\"\n\nexport function CouponField() {\n ...complete file...\n}\n"
},
{
"path": "test/checkout/coupon-field.test.ts",
"content": "import { describe, expect, test } from \"vitest\"\n...complete file...\n"
}
]
كل عنصر مسار نسبي والملف كاملا بعد التغيير، لا جزء منه. تكتب المنصة الملفات وتترك لـ git حساب الفروقات، فيظهر الملف المعدل رقعة (patch) عادية والملف الجديد إضافة.
المشاريع التي لا مستودع لها تعمل أيضا. فمهمة مثل «ابن أداة صغيرة لاختصار الروابط بلغة Python» تكتب في مستودع git مؤقت ينشأ من الصفر، وتنتج الجلسة مع ذلك فروقات قابلة للتنزيل. وتتيح صفحة Source تصفح ذلك الكود، معادا بناؤه من الفروقات.
العمل على التغيير
- صفحة Changes تسرد كل تغيير مقترح وحالته وتكلفة إنتاجه.
- صفحة الجلسة تعرض الفروقات والملفات المتغيرة ومحضر الخطوات خطوة بخطوة.
- يمكنك تعديل ملفات الذكاء الاصطناعي في لوحة التحكم قبل الموافقة. يكتب كل تعديل في سجل التدقيق، وتعود الموافقة الممنوحة من قبل إلى حالة الانتظار، لأن الكود لم يعد هو ما جرت الموافقة عليه.
- جلسة المتابعة تبني على تغيير أم لم يدمج بعد. تطبق فروقات الأم أولا وتعرض على النموذج، فيعمل طلب مثل «أصلح الآن الخطأ في ما كتبته» على الكود الذي كتب فعلا.
- زر Fix على الملاحظة يبدأ تشغيلا جديدا موجها إلى تلك المشكلة وحدها.
- ميزة Terminal تعطيك واجهة أوامر (shell) في بيئة معزولة للمشروع، للفحوص التي تريد تشغيلها بنفسك.
بوابات الجودة المعنية
لمرحلة البناء فحوصها الخاصة قبل أن يرى أي إنسان التغيير:
- يجب أن تنتج جولة كتابة الكود ملفات صالحة للاستخدام. الإجابة المقطوعة يحتفظ بما كتبته ويطلب باقيها، حتى خمس مرات إضافية: بقية الملف الذي توقفت فيه، والملفات التي لم تصل إليها. تزال من الملفات علامات الفروقات الشاردة، والملف الذي لا يقبل التحليل يطلب مرة أخرى؛ فإن بقي غير قابل للتحليل سجل ملاحظة بخطورة high. وإذا فشل استدعاء النموذج، أو بقيت الإجابة ناقصة، أو لم يحلل شيء على أنه تغييرات ملفات، تنتهي الجلسة فاشلة مع ذكر السبب. ولا تظهر أبدا مكتملة بلا كود.
- حد الحجم. الفروقات التي تتجاوز نحو 60 KB ترفض كلها، مع رسالة تطلب تقسيم المهمة. ولا تقتطع أبدا إلى جزء يراجع منقوصا.
- الميزانية. يفحص حد الإنفاق الصارم لمساحة العمل قبل جولة كتابة الكود، كما في كل استدعاء آخر للنموذج.
- السياسة على الملفات. حين يوشك التغيير أن يصبح طلب سحب، يفحص كل ملف يغيره وفق قواعد
diff.applyلديك، ويفحص المستودع وفقgithub.push. يمكن للقاعدة أن تسمح أو تطلب موافقة أو ترفض، مثلا لكل ما يقع تحتinfra/**. راجع الموافقات والسياسات.
بعد البناء، ينتقل التغيير إلى اختبارات المشروع، ثم إلى خطوات المراجعة والاختبار في سير العمل، ثم إلى مراجعة الملاحظات للفروقات الفعلية، ثم إلى شخص. وكل ذلك ملخص في صفحة بوابات الجودة.
الحدود
تقرأ جولة كتابة الكود مقدارا ثابتا مما كتبته الخطوات السابقة لها، فإذا طالت تلك الخطوات قد يقتطع آخرها مما تراه. ولإجابتها حجم ثابت، فالتغييرات الكبيرة جدا تفشل ولا تصل. وتعالج 25 ملفا على الأكثر في التغيير الواحد. أبق المهام صغيرة، واستخدم جلسات المتابعة للبناء على مراحل.
الأسئلة الشائعة
هل يدفع الذكاء الاصطناعي مباشرة إلى فرعي الرئيسي؟
لا. يبقى التغيير فروقات مقترحة داخل AI CodeOps إلى أن يجتاز بوابة الجودة ويوافق عليه شخص. عندها يفتح AI CodeOps طلب سحب على فرع جديد.
على أي خدمات استضافة Git يستطيع فتح طلبات السحب؟
على GitHub و GitLab (في صورة merge request) و Bitbucket و Gitea و Forgejo، عبر اتصال git الخاص بمن بدأ الجلسة. يوضع التغيير على فرع جديد اسمه codeops/run- متبوعا بمعرف الجلسة.
هل يمكنني تعديل الكود الذي كتبه الذكاء الاصطناعي قبل إطلاقه؟
نعم. يمكنك تعديل الملفات في تغيير الجلسة أو إضافتها أو حذفها من لوحة التحكم. يسجل كل تعديل في سجل التدقيق، وتعود أي موافقة على التغيير إلى حالة الانتظار.
ماذا يحدث مع تغيير كبير جدا؟
التغيير الذي تتجاوز فروقاته نحو 60 KB يرفض كله وتنتهي الجلسة مع ذكر هذا السبب. قسّم المهمة إلى جلسات أصغر بدلا من ذلك.
هل تستطيع جلسة ثانية أن تبني على كود الجلسة الأولى؟
نعم. جلسة المتابعة تطبق أولا تغيير جلستها الأم الذي لم يدمج بعد، فتحتوي فروقاتها على تغيير الأم مضافا إليه تغييرها.