وثائق

تنفيذ مهمتك الأولى

حدد تفاصيل المهمة، ووافق على الخطة، ثم راقب كيف يقوم Coroid ببنائها والتحقق من صحتها.

مهمة مهمة هي وحدة عمل واحدة تنتهي بـ pull request واحد. ابدأ مهمة من عمل جديد، واختر مهمة ضمن إنشاء كـ. تركه على تلقائي يسمح لـ Coroid باختيار ما بين مهمة أو خطة.

اختر مهمة أولى مناسبة

أفضل مهمة أولى هي صغيرة وحقيقية وقريبة من اختبارات موجودة. شيء مثل "إضافة --json إضافة علامة إلى أمر التصدير، بما يتوافق مع شكل المخرجات الذي يقبله أمر الاستيراد بالفعل" يمنح Coroid هدفًا واضحًا ويمنحك نظرة واضحة على النتيجة.

تجنّب القيام بذلك في الجلسة الأولى:

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

صف ما تريده.

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

لست مضطرًا لكتابة الخطة؛ فهذا أول شيء ينتجه Coroid، ويمكنك الموافقة عليه.

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

عمل جديد
صف النتيجة المرجوة؛ ستجد Coroid الطريقة المناسبة لتحقيقها.
إنشاء كـ
تلقائيمهمةخطة
Coroid يختار النتيجة، أو يمكنك اختيارها بنفسك.
مشروع
web-app
عنوان العمل
تمكين العملاء من تصدير فواتيرهم بصيغة CSV
ملخص

تطلب فرق المالية باستمرار فواتيرهم بصيغة جدول بيانات. أضف زر تصدير إلى قائمة الفواتير لتنزيل الفلتر الحالي بصيغة CSV.

يُعتبر مكتملاً عندما: يفتح الملف في برنامجي Excel وNumbers، وتستخدم المبالغ عملة الحساب، ولا يتعرض التصدير لأكثر من 10,000 صف إلى تأخير في الاستجابة.

إرفاق ملفات
التالي: التأهيل. لم يتم إنشاء أي شيء بعد.متابعة

نموذج العمل الجديد: اختر ما تريد إنشاءه، حدد المشروع، ثم صِف النتيجة في عنوان ووصف مختصر.

استمر في مرحلة التأهيل.

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

مراجعة المواصفات

تحوّل Coroid وصفك إلى مواصفات: ما الذي سيتم بناؤه، وما الذي يقع خارج نطاق العمل، ومعايير القبول التي تحدد النجاح. تظهر هذه المعلومات في علامة تبويب مواصفات المهمة.

اقرأها قبل البدء في أي عملية بناء. إذا لم تتطابق معايير القبول مع متطلباتك الفعلية، فقم بتصحيحها الآن؛ فهي المعايير التي ستُستخدم في مرحلة التحقق لاحقًا. انظر إلى مواصفات.

الموافقة على الخطة

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

هذه هي أسهل مرحلة للتدخل. رفض الخطة يكلفك دقيقة واحدة فقط، بينما رفض نتيجة عمل pull request يكلفك تشغيلًا كاملًا.

تابع سير العملية

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

ليس عليك متابعة العملية بنفسك؛ فالإشعارات ستخبرك عند الحاجة إليك أو عند اكتمال العملية.

ما الذي يمكن توقعه

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

التالي

مراجعة النتيجة ودمجها — ما الذي سيتم تسليمه، وما الذي يجب فحصه.