وثائق

طرق بدء العمل

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

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

مسارمتى تُستخدم؟
عمل جديديرغب شخص ما في شيء ما ويريد وصفه
استيراد المسائلالطلب موجود بالفعل في Jira أو Linear أو Trello أو GitHub Issues
اسأل Coroidتفضل وصفه بشكل حواري
Slack أو Telegramيطلب شخص ما ذلك عبر الدردشة
استقبال المهام في APIنظام آخر يسجل الطلب، مثل نموذج طلب ميزة في منتجك
عمليات أتمتة الأحداثيجب أن يتحول شيء ما في GitHub أو Slack أو Telegram أو Jira إلى مهمة
Coroid MCPمساعد أو وكيل مثل Hermes أو Codex أو Claude Code يدير المهمة
جداول زمنيةالمحفّز هو الوقت
وصلاتالمحفّز هو حدث من المنصة
تقارير ونتائجتقرير أو فحص جودة كشف عن مشكلة يجب إصلاحها

طلبات

  • عمل جديد

    يصفه أحدهم

  • استيراد المشكلات

    من أداة تتبع

  • استقبال البيانات عبر API

    منتجك أو وكيل

  • تلقائية الأحداث

    pull request، تعليق أو رسالة

تأهيل

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

يتحول إلى

  • مهمة
  • خطة
  • تقرير
  • جدول زمني

اختر واحدة، أو اترك خيار Create على الوضع التلقائي ودع Qualification يقوم بالاختيار.

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

المهام والخطط: مواصفات، خطة، بناء، تحقق، مراجعة، pull request

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

تم التحقق ثم توجيهه

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

تمر طلبات استقبال المهام في API عبرها أيضًا، وكذلك الأحداث التي ترسلها عمليات أتمتة الأحداث إلى مرحلة التأهيل.

ما يتحول إليه يندرج ضمن أحد المسارات الأربعة التالية:

مسارينتج
مهمةمهمة واحدة تنتهي بـ pull request واحد
خطةخطة مرحلية توافق عليها قبل كتابة الكود
تقريرتقرير تم إنشاؤه
أتمتةعمل يتم تنفيذه وفق جدول زمني أو عند حدوث حدث معين

في نموذج العمل الجديد، يمكنك اختيار المسار بنفسك، أو ترك الأمر على الوضع التلقائي تلقائي ودع Qualification تقرر. عندما تختار مسارًا ويوصي Qualification بمسار آخر، ستظهر لك التوصية لتقرر.

طريقة عمل Coroid تختلف؛ في وضع المساعد، يقوم مساعد الدردشة بإنشاء مهام وخطط مباشرة دون تدخل Qualification. أما دردشة Prepare Work، وهي سير عمل SDLC موجه، فترسل مواصفاتها الموافق عليها إلى Qualification قبل بدء التخطيط. اطلع على مساعد الدردشة.

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

عند بدء العمل

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

المصدريبدأ تلقائيًا
حساب خدمة مُعد لبدء العمل المؤهل تلقائيًانعم
حساب GitHub pull request أو مشكلة يكون لدى مؤلفها صلاحيات كتابة في المستودعنعم
تعليق من GitHub يذكر فيه Coroid، ويُحتسب فقط إذا كان من كتّابنعم
أي حساب خدمة آخرلا
Slack، Telegram، Jira وأي مصدر آخرلا

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

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

الطلب الذي لا يحدد مشروعًا ما يذهب إلى المشروع الوحيد في المنظمة؛ وإذا وجد عدة مشاريع، فإن الطلب ينتظر المراجعة في Qualification، حيث يختار المراجع المشروع عند قبوله.

مهمة أم خطة؟

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

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

عمل مستورد

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

من أنظمتك الخاصة

يمكن لنظام آخر تقديم الطلبات عبر بوابة استقبال العمل API: على سبيل المثال، نموذج لطلب ميزة في منتجك الخاص، أو أداة دعم تنقل ما يطلبه العملاء.

تتطلب بوابة API حساب خدمة، وهو متضمن في خطط Professional وEnterprise. يمكنك إنشاؤه تحت إعدادات → حسابات الخدمة. يتطلب مفتاح API هذا النطاق: intake:write. يتم عرض المفتاح مرة واحدة عند إنشائه، وتؤدي إلغاء تفعيل حساب الخدمة إلى رفض جميع مفاتيحه.

أرسل كل طلب إلى بوابة API، مع استخدام المفتاح كرمز وصول:

curl -X POST https://api.coroid.ai/api/v1/organizations/work/intake \
  -H "Authorization: Bearer ak_…" \
  -H "Content-Type: application/json" \
  -d '{"title": "Export invoices as CSV", "content": "Customers want to download their invoices as CSV from the billing page."}'
حقلمطلوبالوصف
titleنعماسم مختصر، بحد أقصى 500 حرف
contentنعمنص الطلب نفسه، بحد أقصى 20,000 حرف
projectIdلاالمشروع الذي ينتمي إليه العمل
workTypeلاtask، plan، report أو schedule
signalلاالخطأ أو التنبيه أو المشكلة التي ينبع منها الطلب، كما هو موضح أدناه

بدون نوع عمل، تقوم عملية التأهيل بتحديد المسار المناسب. تُطبق عملية التأهيل على كل طلب من API ولا يمكن تخطيها.

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

signal حقلمطلوبالوصف
fingerprintنعمهوية ثابتة للحادث، مثل معرف المشكلة في أداة تتبع الأخطاء الخاصة بك
sourceلامصدر الإشارة، على سبيل المثال glitchtip أو sentry
routesلاالطرق التي يتأثر بها الحادث، حتى 50 طريقًا.
minExposureلاكم عدد الطلبات على تلك الطرق التي يجب معالجتها قبل تقييم النتيجة؟
urlلارابط إلى الحادث.

مع routes و minExposure، يصبح العقد قابلًا للقياس: يجب أن يظل الحادث صامتًا. بدونهما، يسجل العقد أنه لا يمكن قياسه. توجيه يمكنه رفض البدء في العمل غير القابل للقياس.

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

يمكن أن تصبح الأحداث في GitHub وSlack وTelegram وJira طلبات أيضًا، دون الحاجة إلى إعادة كتابتها من قبل أحد. ترسل أداة أتمتة الأحداث هذه الطلبات إلى مرحلة التأهيل. انظر محفزات ووجهات.

من مساعديك

يمكن لمساعد أو وكيل تقوم بتشغيله، مثل Hermes أو Codex أو Claude Code، أن يعمل مع Coroid عبر خادم MCP الخاص به. يمكنه قراءة مشاريعك وعملك، وإنشاء وتشغيل وتسليم العمل ضمن النطاقات التي تمنحه إياها. العمل الذي ينشئه لا يمر عبر مرحلة التأهيل. انظر Coroid كخادم MCP.

إدخال آلي

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

تؤدي عمليات التحقق من الجودة أيضًا إلى عمل تصحيحي. عندما تتحقق سياسة الجودة من تقرير وتجد مشاكل في المنتج، يفتح Coroid مهمة تصحيح لها. مصنع → مراجعة تعرض قائمة حالات فشل الاختبارات التي لا تملك أي مهمة مرتبطة بها. تصحيح تحوّل واحدة منها إلى مهمة تصحيح.

كل هذه العمليات تستهلك حصص الوكلاء الحقيقية ونفقات النماذج الحقيقية. امنح العمل الآلي أولوية أقل من العمل الذي ينتظره شخص ما — انظر السعة وحصص الوكلاء.

في هذا القسم