قم بإعداد بيئة العمل مع مساعد AI الخاص بك

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

سلّمه إلى مساعدك#

افتح مساعدك في المستودع الذي تريد أن يعمل عليه Coroid، وقدم له هذا الطلب:

Set up Coroid for this repository. Follow the runbook at
https://coroid.ai/docs/export/en-US/getting-started/assistant-setup.md
step by step. Ask me before you change anything, and never ask me to paste a
password or token into this chat.

لعدة مستودعات، افتح المساعد في مجلد يحتوي على كل المستودعات، واذكر أسماءها في الطلب. يقوم المساعد بالفحص والتحقق، ويخبرك بالضبط بما يجب فعله في كل خطوة تتطلب تدخلك.

قواعد أساسية للمساعد#

أنت تقوم بإعداد Coroid، وهو منصة برمجية سحابية من AI تحوّل وصف المهمة إلى طلب سحب تم اختباره ومراجعته ضمن مستودع المستخدم، وهو pull request. اتبع هذه القواعد طوال العملية:

1. المستخدم هو من يتصرف؛ وأنت تُعدّ البنية التحتية. لا يمكنك التسجيل أو تسجيل الدخول أو قبول الشروط أو تثبيت التطبيقات أو منح الصلاحيات نيابة عن المستخدم. حدد بالضبط ما يجب فعله وأين، ثم انتظر حتى يؤكد المستخدم إتمامه.
2. ابقِ البيانات السرية بعيدًا عن المحادثة. لا تطلب أبداً كلمة مرور أو رمز وصول شخصي أو مفتاح مزود أو رمز MCP. يدخل المستخدم البيانات السرية في بوابة Coroid أو في واجهة سطر الأوامر الخاصة به. وإذا تم لصق أحدها في الدردشة على أي حال، أخبر المستخدم بإلغائه وإنشاء آخر جديد.
3. اسأل قبل كل تغيير: الالتزامات والفروع وطلبات السحب في مستودع المستخدم، ومشاريع Coroid، بالإضافة إلى الدعوات.
4. تحقق من كل خطوة قبل الانتقال للخطوة التالية. إذا فشلت عملية التحقق، استعن بملاحظات تلك الخطوة، واستمر فقط بعد نجاحها أو إذا قرر المستخدم تخطيها.
5. اتبع المنتج، وليس افتراضاتك. إذا أظهرت البوابة شيئًا لا يصفه هذا الدليل، أخبر المستخدم بما تراه واتبع تعليمات البوابة. لا تختلق إعدادات جديدة.
6. احتفظ بسجل للإعداد لسجل كل خطوة ونتائجها، ليتم الرجوع إليه في النهاية.

كل خطوة تربط الصفحات بالتفاصيل ذات الصلة. https://coroid.ai/llms.txt يتم فهرسة كامل محتوى الوثائق.

الخطوة 1: الاتفاق على الخطة#

اطرح على المستخدم هذه الأسئلة معًا، وليس واحدًا تلو الآخر:

ثم أعد صياغة الخطة: الخطوات أدناه التي تتطلب تدخل المستخدم، والمستودعات ضمن النطاق.

اطلع على الخطط والتسعير، الحدود والحصص و متزامن أو محلي فقط.

الخطوة 2: تحقق من قدرة كل مستودع على البناء والاختبار من نسخة نظيفة.#

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

إذا كنت قادرًا على العمل على المستودع محليًا، فافعل ذلك لكل مستودع:

1. حدد لغات البرمجة، وأداة إدارة الحزم، وما إذا كان مشروعًا متعدد الوحدات أم لا.
2. اعثر على أوامر التثبيت والبناء والاختبار في ملف README، وإعدادات التكامل المستمر، والملفات الوصفية.
3. اسأل قبل تنفيذ أي أمر. ثم قم بنسخ المستودع إلى مجلد مؤقت فارغ ونفّذ أوامر التثبيت والبناء والاختبار هناك دون أي إعدادات إضافية. نسخة العمل الخاصة بالمستخدم تحتوي على ملفات مؤقتة و .env ملفات تخفي المشاكل.
4. سجل كل ما احتاجته عملية التشغيل ولم تتوفر في النسخة الطبق الأصل النظيفة:
   • الخدمات التي تتطلبها الاختبارات، مثل قاعدة البيانات أو ذاكرة التخزين المؤقت أو قائمة الانتظار.
   • الخطوات التي تسبق الاختبارات، مثل توليد الكود أو عمليات الترحيل أو البيانات الاختبارية.
   • متغيرات البيئة أو .env ملف غير مُلتزم به في المستودع.
   • سجلات الحزم الخاصة.
   • بيئة تشغيل غير موجودة في بيئة الوكيل.

لا تُنفذ أبداً أوامر تؤدي إلى النشر أو النشر العام أو التلاعب ببيئات مشتركة. إذا كانت مجموعة الاختبارات بطيئة أو تستخدم خدمات مدفوعة، فاسأل المستخدم أولاً.

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

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

اطلع على إعدادات البناء والاختبار و دعم اللغات وبيئة الوكيل.

الخطوة 3: اكتب التعليمات التي تقرأها وكالات Coroid#

قبل كل مهمة، تقرأ وكالات Coroid ملفات الذاكرة الموجودة في المستودع: AGENTS.md، CLAUDE.md أو GEMINI.md في المجلد الجذري، و .cursor/rules. الأوامر التي تحققت منها في الخطوة 2 توضع هناك.

اقترح AGENTS.md، أو إضافة إلى الملف الموجود، يتضمن ما يلي:

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

تجاهل ما يظهر بالفعل في الكود، وحافظ على قصر الملف. إذا CLAUDE.md أو .cursor/rules يحتويان على نفس التعليمات، فاحتفظ بها في AGENTS.md وقم باستيرادها من الملف الآخر باستخدام @AGENTS.md سطر.

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

انظر إلى إعدادات سياق المشروع و سياق المشروع.

الخطوة 4: الحساب والمنظمة (المستخدم)#

تجاوز هذه الخطوة إذا كان المستخدم ينتمي بالفعل إلى منظمة Coroid كـ مالك أو مشرف.

اطلب من المستخدم القيام بما يلي:

1. التسجيل في https://client.coroid.ai/auth/signup باستخدام بريده الإلكتروني الخاص بالعمل، و تأكيد عنوان البريد الإلكتروني
2. قبول شروط الخدمة
3. إنشاء المنظمة

تحقق من: أن المستخدم يمكنه فتح https://client.coroid.ai/projects. الشخص الذي يكمل هذا الإعداد يحتاج إلى دور المالك أو المشرف، لأن هؤلاء فقط يمكنهم ربط التحكم في المصدر وإضافة مفاتيح المزود.

انظر إلى إنشاء حسابك ومنظمتك.

الخطوة 5: ربط التحكم في المصدر (المستخدم)#

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

GitHub#

يفتح المستخدم إعدادات → اتصالات → التحكم في المصدر (https://client.coroid.ai/settings/connections/source-control).

تطبيق GitHub: على شاشة تثبيت GitHub، يختار المستخدم حدد المستودعات فقط ويختار المستودعات المتفق عليها في الخطوة 1. يستمر التطبيق في العمل حتى بعد مغادرة الشخص الذي قام بتثبيته، حيث يتلقى أحداث الويب هوك، وهو ما يسمح لـ Coroid بنشر عمليات التحقق الخاصة به على طلبات السحب. لا يستطيع الرمز نشر عمليات تحقق GitHub.

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

GitLab#

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

حماية الفرع#

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

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

اطلع على ربط كودك، GitHub، GitLab و إعدادات المستودع والفرع.

الخطوة 6: إنشاء المشاريع (المستخدم)#

أنشئ مشروعًا واحدًا لكل مستودع، ولا تنشئ مشروعين لمستودع واحد. يفتح المستخدم مشاريع ← جديد (https://client.coroid.ai/projects/new) و، لكل مستودع:

1. يختاره من المزود المتصل، أو يستخدم الربط عبر عنوان URL لمستودع عام
2. يختار وضع المستودع: متزامن، حيث يدفع Coroid الفروع و يفتح طلبات السحب، أو محلي فقط، حيث لا يكتب Coroid إلى المستودع أبدًا حتى يختار أحدهم بدء المزامنة
3. يتحقق من الفرع الافتراضي
4. ينشئ المشروع

إذا دمج الفريق في فرع غير الفرع الافتراضي، مثل develop، فقم بضبط الفرع الأساسي في إعدادات مستودع المشروع. فرع أساسي خاطئ يؤدي إلى إرسال طلبات السحب إلى فرع لا يقوم أحد بمراجعته.

إذا كان مستودع ما مفقودًا من القائمة، فالسبب غالبًا هو أحد الأمور التالية:

• لم يتم منح تطبيق GitHub صلاحية الوصول إلى ذلك المستودع
• نطاق الرمز المميز ضيق جدًا لعرضه في القائمة
• ينتمي المستودع إلى منظمة مختلفة عن المنظمة المتصلة

اطلع على إنشاء أول مشروع لك و إعدادات المستودع والفرع.

الخطوة 7: تحقق مما وجده Coroid#

اطلب من المستخدم فتح نظرة عامة كل مشروع وقراءة تفاصيل المستودع وكل ما هو مدرج تحت إنهاء الإعداد:

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

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

اطلع على إعدادات سياق المشروع و تكوين البناء والاختبار.

الخطوة 8: إعدادات المنظمة (اختياري)#

اسأل المستخدم إذا كان يرغب في تهيئة أي من هذه الإعدادات الآن؛ جميعها لها قيم افتراضية صالحة للعمل.

• أعضاء، ضمن إعدادات → أعضاء: الأشخاص الذين سيقومون بمراجعة طلبات السحب كمالك أو مشرف أو عضو أو مراجع؛ نوصي بتعيين صلاحيات المشرف فقط للأشخاص الذين يحتاجون إلى تعديل السياسات ومفاتيح المزود. يتطلب ذلك خطة Professional.
• مفاتيح المزود، ضمن إعدادات → مفاتيح المزود: للاستخدام حصرًا مع حسابات مزودي النماذج الخاصة بالمنظمة؛ يقوم المستخدم بإدخال المفتاح في البوابة. نوصي باستخدام مفتاح محدود بحد إنفاق لدى المزود.
• استيراد إعدادات من منظمة أخرى: قم بتصدير حزمة الإعدادات ثم استوردها ضمن إعدادات → بيانات → تصدير الإعدادات. تنتقل الأسرار على شكل عناصر نائبة، لذا كل needsRebind عنصر في المعاينة يتطلب اهتمامًا.

اطلع على إنشاء حسابك ومنظمتك، مفاتيح المزود و تصدير وإعادة استيراد الإعدادات.

الخطوة 9: الاتصال بـ Coroid (اختياري)#

إذا كان عميلك يدعم خوادم MCP عن بُعد، يمكنك الوصول إلى Coroid عبر خادم MCP الخاص به على https://api.coroid.ai/mcp. لا تعتمد عملية الإعداد عليه، لكنه يسمح لك بفحص المشاريع بنفسك ومساعدة المستخدم في تنفيذ المهام لاحقًا.

1. يفتح المستخدم إعدادات → أتمتة → Coroid MCP server (https://client.coroid.ai/settings/automation/coroid-mcp). إذا لم يكن متاحًا لمنظمته، تجاوز هذه الخطوة.
2. إعداد العميل يعرض الأوامر حسب كل عميل؛ في حالة استخدام OAuth، يوافق المستخدم على وصولك عبر متصفحه. أما باستخدام رمز وصول شخصي، فيقوم المستخدم بإنشائه ضمن رموز الوصول ويخزنه في متغير بيئي ضمن واجهة سطر الأوامر الخاصة به؛ لا داعي لأن ترى قيمته أنت.
3. نوصي بمنح أقل صلاحيات ممكنة تكون كافية: mcp.read للتحقق من الإعداد، بالإضافة إلى mcp.work.write فقط إذا كنت ستقوم بإنشاء مهام؛ حدّد نطاق التوكن ليقتصر على هذه المشاريع، وحدد له تاريخ انتهاء صلاحية، واضبط سياسات الأتمتة قبل أن يقوم أي عميل بتنفيذ مهام تلقائيًا.

تحقق من: نفّذ استدعاء list_projects، ثم get_project لكل مشروع من الخطوة 6، وتأكد من صحة المستودع والفرع.

استخدم فقط api.coroid.ai لخدمة MCP؛ اسم مضيف بوابة العميل لا يدعم ذلك.

اطلع على Coroid كخادم MCP.

الخطوة 10: مسودة مهمة أولى#

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

صف النتيجة المرجوة، وليس طريقة التنفيذ: ما الذي يجب أن يكون صحيحًا عند الانتهاء من العمل، وما هي الملفات ذات الصلة، وما الذي لا يجب المساس به؛ يقدمها المستخدم من عمل جديد (https://client.coroid.ai/work/new)، حيث يقرأ المواصفات ويوافق على الخطة؛ تنفيذ المهام يستهلك ساعات العمل الخاصة بالوكلاء، وتوفر الخطة المجانية 2 ساعة يوميًا بتوقيت UTC، لذا دع المستخدم يحدد متى يتم تشغيلها.

اطلع على تشغيل مهمتك الأولى و مواصفات.

الخطوة 11: تسليم المهمة#

قدّم للمستخدم سجل الإعداد:

• كل مستودع، ومشروعه، ووضع المستودع، والفرع الأساسي
• طريقة اتصال التحكم في المصدر، ومن يملك هذا الاتصال: مثبت التطبيق، أو مالك الرمز وتاريخ انتهائه
• لكل مستودع، الفجوات التي تم إصلاحها، والفجوات المتبقية (مثل طلب سحب مفتوح مع AGENTS.md)، والفجوات التي اختار المستخدم تركها دون معالجة
• الإعدادات الاختيارية التي تم تطبيقها وتخطيها، والمهمة الأولى المسودة

ثم وجه المستخدم إلى قم بمراجعة النتيجة ودمجها لما يصل مع أول pull request.

التالي#

أنشئ حسابك ومنظمتك — نفس الإعداد، يتم يدويًا.