وصف ما تحتاجه

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

التوجيه — اختر النتيجة أولاً#

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

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

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

مشاريع#

اختر المشروع الذي ينتمي إليه هذا العمل. يمكنك إضافة المزيد من المشاريع عندما يمتد العمل عبر مشاريع مترابطة — وهذه هي طريقة تمثيل الأعمال بين المشاريع.

وصف العمل#

حقلان، وكل منهما يؤدي وظيفة مختلفة.

عنوان العمل — اسم مختصر. هذا ما ستبحث عنه لاحقًا في القوائم.

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

Add rate limiting to the public API.

100 requests per minute per API key. Exceeding it returns 429 with a
Retry-After header. Limits are per key, not per IP.

Internal service-to-service calls are exempt — they authenticate with
service tokens, not API keys.

Do not change the existing auth middleware's public interface.

هذا السطر الأخير يقوم بعمل حقيقي. خطوط النطاق هي الفرق بين تغيير مركز ومشروع متوسع.

إعدادات متقدمة#

اختياري، وعادةً ما يتم ضبطه قبل بدء التخطيط.

استخدم سير عمل دورة حياة تطوير البرمجيات#

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

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

هدف#

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

AI profile#

أي النماذج ستنفذ هذا العمل؟ اطلع على ملفات تعريف AI.

فحوصات ضبط الجودة#

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

اطلع على سياسات وضوابط ضبط الجودة.

الأولوية#

P0 إلى P3، مع تعيين افتراضي إلى P2. تحدد الأولوية ترتيب الانتظار عندما يتجاوز عدد الأعمال عدد مساحات الوكلاء المتاحة. وهي لا تزيد من القدرة — اطلع على القدرة ومساحات الوكلاء.

حد الميزانية لكل مهمة مولدة#

الحد الأقصى لكمية السياق التي يمكن أن تستهلكها كل مهمة مولدة. ارفعه للأعمال التي تحتاج إلى قراءة واسعة عبر قاعدة أكواد كبيرة؛ وخفضه للحفاظ على نفقات منخفضة على الأعمال الروتينية.

قيود#

قيود الخطة، والأهداف غير المرغوب فيها، والتبعيات، وقواعد التسليم. هنا توضع الأهداف غير المرغوب فيها بشكل صريح — وهو الحقل الأكثر فعالية لمنع التوسع في النطاق.

نقطة البداية / طلب سحب إلى#

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

main → new Coroid branch → PR into main

Coroid ينشئ دائمًا الفرع العامل. هذه الحقول تغير فقط نقطة التفرع والمكان الذي يصل إليه pull request — ولا يمكنها جعل Coroid يلتزم مباشرةً بفرع موجود.

استخدمها عندما تقوم بالدمج في شيء غير فرعك الافتراضي، مثل develop فرع أو قطار إصدار.

إضافة سياق داعم#

ملفات اختيارية ومواصفات منظمة. أرفق مواد خاصة بهذا العمل — تذكرة، مستند تصميم، تتبع مكدس.

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

بدء تشغيله#

إنشاء وبدء التخطيط ينشئ الخطة من ملخص عملك ويبدأ التخطيط فورًا.

ذات صلة#

• طرق بدء العمل
• تطوير مدفوع بالمواصفات
• خطط