AI CodeOps

مستودع أحادي: إعادة هيكلة بعدة وكلاء وبسقف للتكلفة

آخر تحديث

أعد هيكلة حزمة واحدة من مستودع أحادي بسير العمل Plan, Build, Review & Test، في ظل ميزانية لمساحة العمل وحد لكل سير عمل، مع اختبارات تقتصر على الحزمة المتغيرة.

استخدم هذا القالب

إعادة الهيكلة في المستودع الأحادي (monorepo) تسوء بطريقتين: يتمدد التغيير عبر الحزم، وتتمدد الفاتورة معه. وهذا القالب يوجه سير العمل الافتراضي إلى حزمة واحدة ويضع سقفا للاثنين.

الوكلاء الذين يعملون

سير العمل Plan, Build, Review & Test هو سير العمل الافتراضي:

  1. خطوة Plan، ويتولاها وكيل Architect: الملفات التي ستتغير، والترتيب، والمخاطر، مثل المستدعين الذين يعتمدون على توقيت إعادة المحاولة الحالي.
  2. خطوة Build، ويتولاها وكيل Builder: التعديلات الدقيقة، ملفا ملفا.
  3. خطوة Review، ويتولاها وكيل Reviewer: الحالات الحدية وتغيرات السلوك في الفروقات المكتوبة.
  4. خطوة Test، ويتولاها وكيل Tester: الحالات التي تثبت أن السلوك لم يتغير، مفحوصة في ضوء تشغيل الاختبار المسجل.

بعد Build، تكتب جولة كتابة الكود الفروقات، وتعمل اختباراتك عليها. وتأتي Review و Test بعد ذلك، فتقرآن التغيير ونتيجة اختباره، لا خطة. ثم تقرأ مراجعة الملاحظات بالذكاء الاصطناعي الفروقات. والملاحظات المفتوحة بخطورة high أو critical والاختبارات الفاشلة تمنع طلب السحب، ويوافق عليه شخص غير الذي بدأ الجلسة، حين يكون في مساحة العمل شخص آخر يملك صلاحية الموافقة.

اقصرها على حزمة واحدة

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

حقل المشروعقيمة مثال
Test commandpnpm --filter @acme/billing test
Default branchmain

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

ضع سقفا للإنفاق

من Configure → Billing، اختر Configure budget واحفظها، ثم اختر Edit limits:

الحقلقيمة مثال
PeriodMonthly
Soft limit (USD)150
Hard limit (USD)200
Per-workflow caps (USD)Plan, Build, Review & Test: 40

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

قسّم عمليات إعادة الهيكلة الكبيرة

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

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

ماذا يحدث حين يبلغ الحد في منتصف الجلسة؟

تفحص الميزانية قبل كل استدعاء للنموذج. فتتوقف الجلسة مع Stopped over budget، وتعرض Blocked by budget.

هل يمكنني وضع حد لكل وكيل على حدة؟

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