كيف تتحول المهمة إلى pull request

هذه هي الصفحة التي تشير إليها بقية المستندات. فهي تحدد اسم كل مرحلة تنفيذية حتى تتمكن المقالات الأخرى من تحديد مكان حدوث كل شيء بدقة.

المسار#

your description
   │
   ▼
   specification   what will be built, and how you will know it worked
   │
   ▼
   plan            the ordered steps, reviewed before any code is written
   │
   ▼
   build           code and tests written in an isolated workspace
   │
   ▼
   verify          your test suite, plus checks and quality gates
   │
   ▼
   review          an automated review pass over the diff
   │
   ▼
   pull request    on a branch, in your repository, waiting for you

مواصفات#

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

هذا أمر مهم لأن معايير القبول هي ما تختبره مرحلة التحقق لاحقًا؛ فالمواصفات الغامضة تنتج عملاً يصعب تقييمه.

يمكنك قراءة وتحرير المواصفات في علامة تبويب مواصفات قبل بدء التنفيذ.

دليل التطوير المدفوع بالمواصفات يشرح كيفية كتابة معايير قابلة للاختبار، وتحديد حدود النطاق، والحفاظ على نفس تعريف النجاح عبر التخطيط والتنفيذ والمراجعة.

تخطيط#

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

رفض الخطة أمر غير مكلف، وهو القرار الصحيح عندما يكون النهج خاطئًا؛ أما رفضها بعد كتابة الكود فهو مكلف. هذه المرحلة هي التي يكون فيها حكمك ذا تأثير كبير.

بناء#

يقوم الوكيل بنسخ المستودع إلى مساحة عمل معزولة والعمل فيها؛ حيث يقرأ الكود، ويكتب التغيير، ويكتب أو يحدّث الاختبارات.

مساحة العمل قابلة للتصرف ومخصصة لكل مهمة؛ لا يؤثر ما يفعله الوكيل على فرعك الافتراضي، ولا يمكن لمهمتين تعملان في نفس الوقت رؤية عمل بعضهما البعض.

تحقق#

تُشغَّل مجموعة الاختبارات الخاصة بك أولاً؛ وهذا أقوى مؤشر متاح، لأنه يعكس ما قرر فريقك أنه مهم.

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

مراجعة#

يقرأ وكيل المراجعة الاختلافات بنفس طريقة زميلك ويخرج نتائج. النتائج التي يمكن تصحيحها تُرسل للتعديل؛ أما الباقي فيُرفق بـ pull request حتى تراها.

لهذا السبب يصل طلب سحب المراجعة Coroid pull request وقد تمت مراجعته مسبقًا — وليس لاستبدال مراجعتك، بل لكي لا تكون مراجعتك الأولى.

طلب سحب#

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

تتوقف عملية Coroid هنا؛ عملية الدمج من اختصاصك.

حالات المهمة#

توضح حالة المهمة مكان وجودها في المسار المذكور أعلاه:

ما الذي يحدد معدل الإنجاز؟#

مساحة للوكيل تُشغِّل مهمة واحدة في كل مرة؛ تحدد المساحات مدى التوازي في إنجاز العمل، ولا تجعل أي مهمة تنتهي بشكل أسرع. يحدد مدة المهمة حجم التغيير ووقت تشغيل مجموعة الاختبارات الخاصة بك.

التالي#

أدوار الوكيل — أي وكيل يتولى أي مرحلة، وما هو مسموح له بفعله.