MCP للكود، وCI، ومزرعة المشغلات، وضمان الجودة
الـ CHAMPREP خادم MCP تتيح لمساعد الذكاء الاصطناعي الخاص بك العمل مع CHAMPREP الكود, مزرعة المشغلات و ضمان الجودة نيابةً عنك: ابحث عن المشاريع وعناوين URL الخاصة بنسخها، وتحقق من مسارات العمل، واقرأ سجلات المهام، وتابع المُشغِّلات ومجموعات المُشغِّلات، وتابع عمليات فحص ضمان الجودة ونتائج الفرز. يعمل المساعد دائمًا بصفته أنت: أدوارك، وخطتك، وسياسات مؤسستك و(مع وجود APIمفتاح) تنطبق نطاقات المفتاح تمامًا كما هو الحال في تطبيقات الويب.
قم بتوصيل عميل الذكاء الاصطناعي الخاص بك بـ https://ai-api.champrep.com/mcp/v1 كما هو موضح في
خادم MCP. يعمل تسجيل الدخول عبر المتصفح للأشخاص الذين يستخدمون لوحة المفاتيح؛ أما بالنسبة للبرامج النصية وCI، فاستخدم APIمفتاحًا. النطاقات ذات الصلة هنا:
| الخدمة | للقراءة فقط | قراءة وتعديل |
|---|---|---|
| CHAMPREP Code | code:read_api | code:api |
| مزرعة Runner | runner_farm:read | runner_farm:write |
| ضمان الجودة | qa:read | qa:write |
العثور على العملية الصحيحة
Section titled “العثور على العملية الصحيحة”عندما يصل حسابك إلى كتالوج كبير (أكثر من حوالي 1,000 عملية، وهو ما يقترب منه Code وحده)، يرى عميلك أداتين مساعدتين بدلاً من أداة واحدة لكل عملية قراءة: champrep_search_tools و champrep_read. يقوم مساعدك بالبحث باستخدام بضع كلمات بسيطة، ويقرأ المدخلات الدقيقة التي يحتاجها، ثم ينفذ العملية. عمليات البحث مثل سجل المهام, أحدث خط أنابيب,
علامات runner, مشاريع المجموعة أو بوابة الجودة العمل: تتم مطابقة كل كلمة بمفردها وتظهر أفضل النتائج أولاً. في هذا الوضع، تتم قراءة
champrep_read؛ مع وجود كتالوج أصغر، يتم إدراج كل عملية كأداة مستقلة. كل تغيير له دائمًا أداة مسماة خاصة به، لذا يمكن لعميلك أن يسألك قبل تشغيلها.
CHAMPREP Code
Section titled “CHAMPREP Code”
المشاريع والمجموعات والاستنساخ
Section titled “المشاريع والمجموعات والاستنساخ”- أدرج قائمة بالمشاريع التي يمكنك الوصول إليها، أو كل مشروع تابع لمجموعة مع جميع مجموعاتها الفرعية. يأتي كل مشروع مع عناوين URL الخاصة بالاستنساخ عبر HTTPS وSSH.
- انسخ مجموعة بأكملها. لا يمكن لـ MCP التشغيل
gitعلى جهازك. اطلب خطة استنساخ بدلاً من ذلك:code_clone_group_planتسرد كل مشروع من مشاريع المجموعة (بما في ذلك المجموعات الفرعية) وتُرجع أوامر جاهزة للتشغيلgit cloneأوامر تحافظ على تنسيق مجلدات المجموعة. يتم تخطي المجلدات الموجودة بالفعل، لذا يمكنك تشغيل القائمة مرة أخرى. قم بتشغيلها بنفسك في بيئة POSIX shell، أو دع أحد وكلاء البرمجة المحليين (Claude Code، Codex، Cursor) يقوم بتشغيلها في محطتك الطرفية. - يتطلب النسخ عبر SSH وجود مفتاح SSH في ملفك الشخصي على Code. أما النسخ عبر HTTPS فيطلب اسم المستخدم الخاص بك ورمز وصول شخصي تقوم بإنشائه في Code: لا تقم أبدًا بلصق رمز الوصول في الدردشة.
مسارات المعالجة والمهام
Section titled “مسارات المعالجة والمهام”- حالة مسار العمل لكل فرع، وأحدث مسار عمل لفرع ما، والمهام الخاصة بـ مسار العمل، وملخص تقرير الاختبار.
- سجلات المهام. اقرأ سجل المهمة؛ بالنسبة للسجلات الطويلة، يقرأها المساعد على أجزاء مع نطاق بايت، حتى يتمكن من الانتقال إلى نهاية المهمة الفاشلة.
- تشغيل مسار جديد، أو إعادة محاولة مسار أو إلغاؤه، أو تشغيل مهمة يدوية، أو إعادة محاولة مهمة واحدة أو إلغاؤها.
- قائمة وتنزيل مكونات المهام (الأرشيفات الصغيرة؛ أما الأرشيفات الكبيرة فيتم تنزيلها من Code).
المشغلات
Section titled “المشغلات”- قم بإدراج قائمة بـ«الرانرز» الخاصة بك، و«الرانرز» الخاصة بالمشروع (الخاصة به، والمميزة لمجموعاته، و «الرانرز» الخاصة بالمثيلات التي يمكنه استخدامها)، و«الرانرز» الخاصة بالمجموعة، مع الحالة، وحالة الاتصال بالإنترنت، والعلامات، وحالة الإيقاف المؤقت، وآخر اتصال.
- اطلع على تفاصيل برنامج التشغيل والمهام التي نفذها، وعدد المهام التي تنتظر تنفيذها بواسطة برنامج التشغيل.
- تسجيل مشغل جديد. يفتح المساعد صفحة «new-runner» في Code الخاصة بالمشروع أو المجموعة. تحصل على رمز المشغل هناك: ولا يُعرض هذا الرمز أبدًا للمساعد.
- تغيير برنامج التشغيل: أضف أو أزل العلامات، أو أوقفها مؤقتًا أو استأنفها، أو غيّر وصفها، أو حدد ما إذا كانت ستُشغّل مهامًا غير مُعلَّمة، أو حدد مستوى الحماية أو الحد الأقصى لمدة الانتظار. تُرسَل العلامات كقائمة جديدة كاملة، لذا يقرأ المساعد المُشغِّل أولاً. لا يتم تنفيذ أي تغيير إلا بعد موافقتك عليه.
- التعيين مشغل مشروع موجود إلى مشروع آخر تديره.
- حذف مُشغّل، أو فصله عن أحد المشاريع: إجراءات تدميرية (انظر ما يحتاج إلى موافقتك).
- يحدد الكود من يمكنه تغيير أي مشغل: تحتاج مشغلات المشاريع والمجموعات إلى دور «المسؤول عن الصيانة» أو «المالك»، بينما تحتاج مشغلات المثيلات إلى مسؤول كود.
- يمكن للمساعد أيضًا تزويدك برابط مباشر إلى صفحة إعدادات المشغل في Code.
طلبات الدمج والمشكلات
Section titled “طلبات الدمج والمشكلات”قائمة طلبات الدمج وقراءتها وفتحها وتحديثها والموافقة عليها ودمجها؛ التعليق على طلبات الدمج والمشكلات؛ قائمة المشكلات وإنشاؤها وتحديثها. تحدد الموافقة الفرع المستهدف الذي قرأه المساعد، بحيث لا تتم الموافقة على طلب دمج أعيد توجيهه عن طريق الخطأ.
مزرعة Runner
Section titled “مزرعة Runner”- حساباتك ومساحات العمل الخاصة بك في Runner Farm، ودورك، و فئات الأجهزة والحدود القصوى لخطتك.
- اتصالات مضيف الكود: قم بإدراجها وقراءتها؛ أو قم بإعادة تسمية اتصال ما أو إيقافه مؤقتًا أو استئنافه أو وضع علامة عليه .
- المجموعات: عرضها وقراءتها (بما في ذلك أوقات الانتظار)، وإنشاء مجموعة، وإعادة تسميتها، وإيقافها مؤقتًا، واستئنافها أو التوسع (التزامن ومهلة المهمة)، واستعادة مجموعة أو اتصال من «المحذوفة مؤخرًا».
- الرصيد والاستخدام: رصيدك، والاستخدام الشهري، والفئة، والمجموعة، أو المشروع، ودفتر الرصيد.
- المهام: المهام الجارية والمعلقة والمرفوضة، وتفاصيل مهمة واحدة.
- ربط مضيف الكود ورمز التشغيل الخاص به، وأسرار الموصل، تتم في تطبيق Runner Farm: يزودك المساعد برابط آمن ولا يرى بيانات الاعتماد أبدًا.
ضمان الجودة
Section titled “ضمان الجودة”- المستودعات: عرض قائمة بالمستودعات المتصلة والمتاحة، وتفعيلها و مزامنتها؛ وكذلك مشاريع الكودCHAMPREP.
- عمليات الفحص: ابدأ عملية فحص، وتابع حالتها، واقرأ سجلها (يتم حجب المعلومات السرية) واطلع على إجماليات عمليات الفحص الخاصة بك.
- النتائج: عرض قائمة بالنتائج باستخدام عوامل التصفية، إغلاق نتيجة مع ذكر السبب وتعليق، أو إعادة فتحها.
- بوابة الجودة: قرار البوابة بشأن مستودع أو فرع، مع ذكر كل شرط وأسباب الفشل. تعمل هذه الميزة مع المستودعات من CHAMPREP Code و GitHub GitLabو Bitbucket المرتبطة بـ QA.
- المعاينات: بدء إصدار تجريبي لفرع ما، وإدراج المعاينات، وقراءة سجلاتها وسجلات البناء، وتمديد فترة المعاينة أو تغيير مستوى ظهورها. يتم تشغيل المستودعات التي تتطلب أسرارًا من تطبيق ضمان الجودة.
- بيئة تطوير سحابية (Cloud IDE): ابدأ جلسة IDE في مستودع أو مساحة عمل فارغة، ثم افتحه من الرابط المؤدي إلى صفحته في تطبيق QA؛ قم بإدراج وقراءة جلساتك. لا يُعرض رمز الوصول الخاص بالجلسة أبدًا للمساعد.
- يستهلك بدء جلسة معاينة أو جلسة IDE رصيد ضمان الجودة (QA) الخاص بخطتك ولا يتم تشغيلها إلا بعد موافقتك عليها.
أمثلة على المطالبات
Section titled “أمثلة على المطالبات”- “أدرج أحدث حالة لخط الأنابيب لكل مشروع في المجموعة acme/platform.”
- “اعرض سجل المهمة الفاشلة في خط الأنابيب الأخير لـ acme/web.”
- “أعد محاولة المهام الفاشلة لخط الأنابيب 4211 في acme/web.”
- “ما هي برامج التشغيل التي يستخدمها acme/web، وأي منها غير متصل بالإنترنت؟”
- “أضف العلامة gpu إلى المشغل 12.” (يقوم المساعد بقراءة العلامات الحالية ويطلب منك الموافقة على القائمة الجديدة.)
- “أوقف المشغل 12 مؤقتًا حتى انتهاء الصيانة غدًا.”
- “ابدأ معاينة ضمان الجودة لفرع الميزة/تسجيل الدخول لـ acme/web.”
- “افتح جلسة عمل IDE سحابية على acme/web.”
- “تسجيل مشغل جديد للمجموعة acme.” (ستظهر لك صفحة «new-runner» في Code.)
- “أعطني أوامر النسخ لكل مشروع في المجموعة acme، بما في ذلك المجموعات الفرعية.”
- “كم عدد المهام التي تنتظر مشغلًا في acme/web حاليًا؟”
- “قم بتوسيع مجمع “build-large” في مزرعة المشغلات الخاصة بي إلى 20 مهمة متزامنة.”
- “كم عدد أرصدة مزرعة المشغلات التي استخدمتها هذا الشهر، لكل فئة جهاز؟”
- “ابدأ فحص ضمان الجودة لـ acme/web وأخبرني عند انتهائه.”
- “أدرج قائمة بنتائج ضمان الجودة المفتوحة ذات الخطورة العالية في acme/web.”
- “تجاهل QA-0970 باعتباره نتيجة إيجابية خاطئة: المفتاح هو جهاز اختبار.”
- “هل اجتاز acme/web بوابة الجودة على الفرع الرئيسي؟”
ما يحتاج إلى موافقتك
Section titled “ما يحتاج إلى موافقتك”- قراءات (القوائم، التفاصيل، السجلات، الاستخدام) لا تغير شيئًا. في الكتالوجات الكبيرة تعمل من خلال
champrep_read. - التغييرات (تشغيل خطوط الأنابيب والمهام أو إعادة محاولتها أو إلغاؤها، وفتح طلبات الدمج أو دمجها ، وإضافة تعليقات، وتغيير المشغلات أو إيقافها مؤقتًا أو استئنافها أو تعيينها، وإنشاء المجموعات أو توسيع نطاقها ، وبدء عمليات الفحص، وإغلاق النتائج، وبدء معاينات ضمان الجودة وجلسات IDE) لكل منها أداة خاصة بها. يحدد عميل MCP الخاص بك كيفية طلب التأكيد منك: راجع إعدادات الموافقة الخاصة به قبل السماح بإجراء التغييرات.
- الإجراءات التدميرية (حذف خط أنابيب، أو حذف مشغل أو فصله عن مشروع، أو حذف تجمع، أو إيقاف جميع مهام مزرعة المشغلات قيد التشغيل) تظل مخفية إلى أن يسمح الاتصال بالإجراءات التدميرية وينتهي عنوان URL بـ
?destructive=true. انظر خادم MCP. - يتم فحص كل تغيير مرة أخرى بواسطة الخدمة وفقًا لدورك وخطة اشتراكك.
ما هو غير متاح، ولماذا
Section titled “ما هو غير متاح، ولماذا”| غير متاح عبر MCP | لماذا | أين يمكن القيام بذلك |
|---|---|---|
التشغيل git (النسخ، الدفع) على جهازك | تعمل أدوات MCP في CHAMPREP، وليس على جهازك | قم بتشغيل الأوامر من code_clone_group_plan، أو استخدم وكيل برمجة محلي |
| رؤية رمز مشغل، أو رمز مشغل في مزرعة المشغلات، أو سر موصل، أو تغيير تاريخ انتهاء صلاحية رمز المشغل | يجب ألا تُذكر بيانات الاعتماد أبدًا في الدردشة أو المطالبة أو السجل | صفحات المشغلات في Code وتطبيق Runner Farm (يقدم لك المساعد الرابط) |
| تغيير إعدادات CI/CD للمشروع (على سبيل المثال، تشغيل برامج التشغيل الفردية أو الجماعية) | يطلب Code تأكيدًا إضافيًا لا يمكن أن يقدمه سواك | إعدادات CI/CD للمشروع في Code |
| تشغيل الأوامر أو تحرير الملفات داخل جلسة IDE السحابية | يظل تنفيذ التعليمات البرمجية التعسفي ضمن بيئة تطوير التطبيقات (IDE) التي تفتحها | بيئة تطوير التطبيقات السحابية (IDE) الخاصة بـ QA |
| إنشاء رموز الوصول، ونشر الرموز أو المفاتيح، وقراءة متغيرات CI/CD | تظل بيانات الاعتماد والأسرار في Code | إعدادات Code |
| تغيير إجراءات الحماية (الفروع المحمية، وقواعد الموافقة، والأعضاء، وإمكانية الرؤية) | يطلب Code تأكيدًا إضافيًا | إعدادات Code |
| تجاهل اكتشاف سر | تأكيد إلغاء سر ما هو شهادة من جانبك | تطبيق ضمان الجودة (QA) |
| إقران Code مع Runner Farm وسر الموصل الخاص بها | يُعد رمز الاقتران والسر بيانات اعتماد | منطقة إدارة Code |
كما تعتمد العمليات التي تراها على خطتك، وسياسات مؤسستك، وأذونات الذكاء الاصطناعي الخاصة بكل خدمة، وبالنسبة لمفتاحAPI API، نطاقات المفتاح.