مهمة مهمة هي وحدة عمل واحدة تنتهي بـ pull request واحد. ابدأ وحدة عمل جديدة من خلال عمل جديد.
اختر مهمة أولى مناسبة
أفضل مهمة أولى هي صغيرة وذات طابع عملي وقريبة من اختبارات موجودة. على سبيل المثال:
«إضافة --json علم إلى أمر التصدير، بحيث يتطابق شكل المخرجات مع ما يقبله أمر الاستيراد حالياً»، هذا يمنح Coroid هدفاً واضحاً ويمنحك تقييماً دقيقاً للنتيجة.
تجنب القيام بما يلي في المحاولة الأولى:
- أي شيء يتعلق بمصادقة المستخدم أو عمليات الدفع أو ترحيل البيانات
- عمل يتطلب قرارًا تصميميًا لم يتم اتخاذه بعد
- تنظيفات غامضة — عبارة «تحسين معالجة الأخطاء» لا تملك خط نهاية محدد.
صف ما تريده.
اكتب النتيجة المرجوة، وليس طريقة التنفيذ. حدد ما يجب أن يكون صحيحًا عند انتهاء العمل، واذكر أي تفاصيل غير واضحة: الملفات المهمة، القواعد التي يجب اتباعها، والأجزاء التي لا يجب التعديل عليها.
لست مضطرًا لكتابة الخطة؛ فهذه أول نتيجة ينتجها Coroid، ويُسمح لك بالموافقة عليها.
إذا كان هناك سياق لا يحمله الكود — مثل قرار تصميم معماري، أو دليل أسلوب، أو تذكرة مهمة — فقم بإرفاقه. اطلع على سياق المشروع لتعرف ما يعرفه Coroid بالفعل دون الحاجة لتوضيحه.
مراجعة المواصفات
Coroid يحوّل وصفك إلى مواصفات: ما سيتم بناؤه، ما يقع خارج نطاق العمل، ومعايير القبول التي تحدد النجاح. تظهر هذه المواصفات في علامة تبويب مواصفات المهمة.
اقرأه قبل البدء في أي بناء. إذا لم تتطابق معايير القبول مع ما تريده فعليًا، قم بتصحيحها الآن؛ فهي الأساس الذي يتم اختباره في مرحلة التحقق لاحقًا. اطلع على COROID_TERM_0. مواصفات.
اعتماد الخطة
بالنسبة لأي تغيير يتجاوز الحد الأدنى، تصبح المواصفات خطة: وهي مجموعة مرتبة من الخطوات. يجب اعتمادها قبل كتابة الكود.
هذه هي أرخص فرصة للتدخل. رفض الخطة يكلفك دقيقة واحدة فقط، بينما رفض pull request المكتمل يكلفك تشغيلاً كاملاً.
شاهده وهو يعمل
بعد الاعتماد، تدخل المهمة في PENDING حتى يتوفر مساحة لوكيل، ثم
IN_PROGRESS. يمكنك متابعة سير العمل بشكل مباشر: الخطوات المنفذة، الأدوات المستخدمة، الملفات التي تم تعديلها، ونتائج الاختبارات أثناء تجميعها.
ليس عليك المراقبة. ستُخطرك الإشعارات عند الحاجة إليك أو عند الانتهاء.
ما يمكن توقعه
- المدة تتحدد بناءً على حجم التغيير ووقت تنفيذ مجموعة الاختبارات، وليس بعدد مساحات الوكلاء المتاحة. تتحكم المساحات في عدد المهام التي تعمل في نفس الوقت.
NEEDS_HUMAN_REVIEWليست فشلاً. هذا يعني أن Coroid وصل إلى قرار يتطلب تدخلك فقط. أجب عليه لتستمر المهمة.- إعادة العمل أمر طبيعي. إذا وجد المراجع أي مشكلة، تُعاد المهمة إلى المطور قبل أن تراها أنت.
التالي
مراجعة النتيجة ودمجها — ما الذي سيصل، وما الذي يجب التحقق منه.