وثائق

حالات المهمة

جميع حالات المهمة الممكنة، أسبابها وما يجب فعله بشأنها.

توضح حالة المهمة مكانها في المسار من الوصف إلى طلب السحب.

الحالةالمعنى
PENDINGتم قبولها، في انتظار توفر مساحة لوكيل.
IN_PROGRESSيتم العمل عليها بشكل نشط.
PENDING_REVIEWاكتمل العمل وتمت مراجعته، في انتظار الدمج أو الموافقة.
COMPLETEDتم تسليمها.
NEEDS_HUMAN_REVIEWلا يمكن لـ Coroid المتابعة بمفرده ويطلب منك توجيهًا.
PAUSEDتوقفت مؤقتًا، ويمكن استئنافها.
FAILEDلم يتم إكمال التنفيذ.
CANCELLEDقمت بإيقافها.
WONT_FIXتم إغلاقها عمدًا دون إنجاز العمل.

قيد الانتظار

في قائمة الانتظار. المهمة صالحة وتنتظر توفر القدرة الاستيعابية.

إذا ظلت هنا لفترة أطول من المتوقع: جميع مساحاتك مشغولة، أو أن المهام ذات الأولوية الأعلى تأتي قبلها. تحقق من الأولوية (P0 إلى P3) و القدرة الاستيعابية. إضافة مساحات يقلص طول قائمة الانتظار؛ لكنه لا يسرع العمل الجاري بالفعل.

قيد التنفيذ

يعمل وكيل عليها. يمكنك متابعة سير التنفيذ مباشرة.

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

قيد المراجعة

تم بناء العمل واجتاز مرحلة المراجعة الآلية. وهو في انتظار الدمج أو موافقتك.

ما يجب فعله: مراجعة pull request. اطلع على مراجعة النتيجة ودمجها.

مكتملة

تم تسليمها. بالنسبة لمعظم المهام، يعني ذلك أن pull request مفتوحة وجاهزة؛ أما الدمج فهو من مسؤوليتك.

تحتاج إلى مراجعة بشرية

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

ما يجب فعله: اقرأ السؤال، أجبه، وستستمر المهمة من حيث توقفت. الإجابة الدقيقة تستحق الجملة الإضافية؛ فالإجابة الغامضة تؤدي إلى تخمين آخر.

إذا رأيت هذه الحالة بشكل متكرر، فالسبب الشائع هو عدم اكتمال تحديد مواصفات العمل. اطلع على مواصفات.

متوقفة

توقفت عمدًا ويمكن استئنافها. تُحرر مساحتها أثناء التوقف.

فاشلة

لم يتم إكمال التنفيذ. يختلف عن العمل الذي تم تنفيذه ولم ينجح — فهذا يعود كعمل إضافي أو نتائج.

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

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

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

ملغاة

قمت بإيقافها. يتوقف التنفيذ ويُحرر المساحة فورًا.

لن يتم إصلاحها

تم إغلاقها عمدًا دون إنجاز العمل — لأنها تم حلها بالفعل، أو غير قابلة للتطبيق، أو تم اتخاذ قرار بعدم القيام بها. يختلف عن CANCELLED في النية: WONT_FIX هو حكم على العمل، CANCELLED هو حكم على سير التنفيذ.