AI CodeOps

وكيل Builder

يصف وكيل Builder تغييرات الكود الدقيقة التي تحتاجها المهمة، ملفا ملفا. ويعمل في ستة من مسارات سير العمل المضمّنة، قبل أن تكتب جولة كتابة الكود الفروقات الفعلية.

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

أين يعمل

سير العملالخطوة
Plan, Build, Review & TestBuild
Security-Sensitive ChangeImplement
UI ImplementationImplement
Incident ResponseMitigation
Performance TuningApply
Quality-Gated ChangeBuild

المدخلات

  • مهمة الجلسة.
  • لقطة للقراءة فقط من الملفات ذات الصلة في مستودع المشروع، أو لا شيء حين يبدأ المشروع من الصفر.
  • الخطوات السابقة. وهي في معظم مسارات سير العمل خطة من وكيل Architect أو وكيل UI Designer. وفي Security-Sensitive Change تشمل أيضا تحليل المخاطر الذي يضعه وكيل Security Auditor. أما في Quality-Gated Change فيعمل وكيل Builder أولا، انطلاقا من المهمة وحدها.

المخرجات

تعيد خطوة وكيل Builder نصا: التغييرات لكل ملف والمنطق وراءها. وهي مدخل واحد من مدخلات ما يحدث بعدها.

في كل سير عمل يعمل فيه، تكون خطوة Builder آخر خطوة قبل كتابة الكود. وبعدها مباشرة تشغل الجلسة جولة كتابة الكود (code pass). تقرأ هذه الجولة المهمة والكود وما أنجزه الفريق حتى الآن (ومنه وصف وكيل Builder)، وتعيد المحتوى الجديد الكامل لكل ملف تغيره. ثم تكتب المنصة تلك الملفات في نسخة مستنسخة مؤقتة وتأخذ فروقات git فعلية. وتلك الفروقات هي ما تراجعه، وما تعمل عليه اختبارات المشروع، وما يدخل المستودع طلب سحب بعد الموافقة.

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

مثال على تشغيل

مثال توضيحي، وليس جلسة مسجلة. في سير العمل Incident Response، فرز وكيل Incident Responder ارتفاعا مفاجئا في أخطاء 500 عند الدفع، وتتبع وكيل Architect سببه إلى رمز عملة فارغ (null) يرسله أحد مزودي الدفع. فتقترح خطوة Mitigation التي يتولاها وكيل Builder شرطا وقائيا في محول الدفع يرجع إلى عملة الطلب، وسطرا في السجل حين يستخدم هذا البديل، وملاحظة متابعة لإصلاح ربط بيانات المزود إصلاحا سليما. وتحول جولة كتابة الكود ذلك إلى فروقات في ملفين، وتعمل عليها اختبارات المشروع. ثم تقرأ خطوة Verify التي يتولاها وكيل Tester الفروقات ونتيجة الاختبار.

الحدود

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

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

هل يعدّل وكيل Builder مستودعي مباشرة؟

لا. إنه يصف التغيير. ثم تكتب جولة منفصلة لكتابة الكود ملفات كاملة في نسخة مؤقتة من المستودع وتنتج الفروقات، ولا تدخل هذه المستودع إلا بعد بوابة الإصدار والموافقة.

أي نموذج يستخدمه وكيل Builder؟

نموذج الجلسة. وعلى فئة Auto تذهب خطوته إلى فئة Economy أولا، وتذهب جولة كتابة الكود التي تكتب الملفات إلى فئة Standard أولا.