هل حاولت يومًا أن تشرح ما هو طلب السحب لصديقك غير التقني ورأيت عينيه تتجمدان مثل سير ناقل في Krispy Kreme؟ تخيل الآن أن تخبرهم أن الذكاء الاصطناعي لا يمكنه فهم مستودع التعليمات البرمجية الخاص بك فحسب، بل يمكنه أيضًا فتح طلبات السحب نيابة عنك. مرحبًا بك في عام 2025، حيث محرر التعليمات البرمجية الخاص بك هو إلى حد ما مساعد طيار، وإلى حد ما سائق في المقعد الخلفي، وإذا قمت بإعداده بشكل صحيح، فهو متدرب لائق تمامًا.
يوضح لك هذا الدليل كيفية ربط GitHub بـ Claude Code وإنشاء طلبات سحب تلقائيًا. سننتقل من "ماذا؟" إلى "أرسل" مع إعداد خطوة بخطوة، وسير عمل واقعي، وعدد قليل من المطبات التي يجب تجنبها. ستقوم بتوصيل GitHub، والسماح لـ Claude Code برؤية ما يحدث، وجعله يفتح ويحدث طلبات السحب التي يمكنك دمجها بالفعل دون الشعور وكأنك عقدت صفقة مع الشيطان الخوارزمي.
تنبيه: سترى مسارين رئيسيين هنا - استخدام تكامل GitHub Actions الخاص بـ Claude Code واستخدام خوادم Model Context Protocol ({MCP}) لمنح Claude وصولاً آمنًا ومحدد النطاق إلى واجهات برمجة تطبيقات GitHub. أيهما يجب أن تختار؟ إذا كنت تريد مساعدة طلب السحب الجاهزة للاستخدام مباشرة في GitHub، فإن مسار Actions هو الأفضل لك. إذا كنت تريد التحكم في المستودع المحلي القائم على الدردشة مع أذونات دقيقة، فإن {MCP} هو أداة القوة الخاصة بك.
ما الذي نبنيه
- ربط GitHub بـ Claude Code بشكل آمن.
- السماح لـ Claude بتحليل المستودع الخاص بك، واقتراح التغييرات، وفتح طلبات السحب.
- أتمتة المراجعات والتصنيفات وقوائم التحقق وحتى المتابعة.
- إضافة حواجز حماية حتى لا يعيد تسمية المستودع الأحادي بأكمله إلى "final_final_v2".
لماذا هذا مهم
لأن تبديل السياق هو ضريبة الإنتاجية التي لم يصوت عليها أحد. الذكاء الاصطناعي الذي يمكنه فتح طلب سحب بنفس الدقة التي تتوقعها من مطور مبتدئ (في يومه الجيد) هو موفر حقيقي للوقت. ليس لاستبدال البشر - اهدأ - ولكن لاستبدال أجزاء "ugh، النماذج الأولية" من الهندسة.
المسار أ: إنشاء طلبات سحب تلقائيًا باستخدام GitHub Actions الخاص بـ Claude Code
إذا كنت تعيش داخل GitHub طوال اليوم (انضم إلى النادي)، فإن هذا المسار يمنحك روبوتًا يمكنه تحليل التعليمات البرمجية في المشكلات وطلبات السحب، واقتراح التغييرات، وحتى فتح أو تحديث طلبات السحب، مباشرة من المستودع الخاص بك.
ما ستحتاجه
- مستودع GitHub تتحكم فيه (أو فرع يمكنك كسره دون بكاء).
- الوصول إلى مسؤول المستودع لتكوين Actions والأسرار.
- مفتاح Claude API إذا كان الإجراء أو سير العمل الخاص بك يحتاجه.
الخطوة 1: تمكين GitHub Actions في المستودع الخاص بك
- انتقل إلى المستودع الخاص بك ← الإعدادات ← Actions ← عام.
- قم بتمكين "السماح بجميع الإجراءات وسير العمل القابلة لإعادة الاستخدام" (أو تقييد الإجراءات المعتمدة لمؤسستك إذا كان مسؤولو الأمان لديك يراقبونك بالفعل).
الخطوة 2: إضافة سير عمل Claude Code
قم بإنشاء .github/workflows/claude-pr-bot.yml مع مشغل يعتمد على سير العمل المفضل لديك. فيما يلي نمطان شائعان:
الخيار 1: طلبات السحب القائمة على المشكلات
- عندما تفتح مشكلة بتسمية خاصة (مثل ai-pr)، يتم تشغيل سير العمل.
- يقرأ مطالبة المشكلة (مثل "إضافة تبديل الوضع المظلم")، وينشئ فرعًا جديدًا، ويحرر الملفات باستخدام Claude، ويدفع الالتزامات، ويفتح طلب سحب بملخص مفصل.
الخيار 2: التعديلات القائمة على التعليقات على طلب سحب موجود
- عندما تعلق @claude يرجى إعادة هيكلة إطار إعدادات الحوار، يتم تشغيل سير العمل.
- يقوم بتحليل الاختلاف، ويقترح التغييرات، ويدفع التحديثات إلى فرع طلب السحب.
سير عمل المبتدئين (رسم تخطيطي رفيع المستوى)
name: Claude PR Bot
on:
issues:
types: .
- يمنحك دليل سريع حول التكامل وحالات الاستخدام نظرة شاملة لما هو معقول لأتمتة (وما ليس كذلك) في الفرق الحقيقية.
- إذا كنت متعلمًا بصريًا، فإن هذا الشرح يوضح طلبات السحب المدعومة بالذكاء الاصطناعي التي يتم إنشاؤها تلقائيًا قيد التنفيذ، من البداية إلى النهاية.
المسار ب: ربط GitHub بـ Claude Code عبر {MCP} (للمستخدمين المتميزين المحليين)
إذا كنت تريد أن يعمل Claude مع سياق المستودع المحلي الخاص بك - الملفات الموجودة على جهازك، والفروع التي تتعامل معها، والأوامر التي تثق بها - فإن {MCP} يمنحك جسرًا مرخصًا. فكر في الأمر على أنه بواب لمستودعك: فهو يقرر الأبواب التي يمكن لـ Claude فتحها.
ما ستحتاجه
- Claude Desktop أو تكامل IDE الذي يدعم أدوات {MCP}.
- خادم GitHub {MCP} تقوم بتشغيله محليًا، تم تكوينه باستخدام رمز مميز يحد من النطاقات.
- رمز وصول شخصي ({PAT}) مع النطاقات التي تحتاجها حقًا فقط (مثل repo:status، public_repo، طلب السحب write).
الخطوة 1: احصل على خادم GitHub {MCP}
- يوجد خادم مفتوح المصدر رسمي يعرض عمليات واجهة برمجة تطبيقات GitHub المحددة (البحث عن المشكلات وإنشاء الفروع وفتح طلبات السحب وما إلى ذلك). إنه قابل للتكوين بحيث تقوم فقط بتمكين ما تحتاجه، مما يقلل أيضًا من ارتباك الذكاء الاصطناعي ويبقي الأمان سعيدًا. للحصول على عرض أوسع لخوادم {MCP} وأمثلة، تحقق من الدليل المركزي.
الخطوة 2: قم بتكوين عميلك للتحدث إلى الخادم
- في ملف تكوين العميل الخاص بك (مثل تكوين JSON لتطبيق الذكاء الاصطناعي الخاص بك)، قم بتسجيل خادم GitHub {MCP}، ومرر الرمز المميز الخاص بك عبر متغيرات البيئة، وقم بإدراج المستودعات المسموح بها في القائمة البيضاء.
- نصيحة احترافية: ضع الرمز المميز في سلسلة مفاتيح النظام أو ملف dotenv، وليس ملف التكوين الخاص بك. لا تصبح المثال التحذيري في اجتماعك العام التالي.
الخطوة 3: اختبار مساحة سطح الأداة
- اطلب من Claude سرد المشكلات المفتوحة أو قراءة ملف معين أو إنشاء فرع. تحقق من أنه لا يمكنه فعل أي شيء لم تسمح به صراحةً.
- فقط بعد التحقق من سلامة الأوامر الأساسية، يجب عليك تمكين create_pull_request.
الخطوة 4: السماح لـ Claude باقتراح وفتح طلب سحب
- مثال المطالبة: "في المستودع org/app-frontend، قم بإنشاء فرع جديد feat/dark-toggle، وقم بتطبيق تبديل إعدادات للوضع المظلم في SettingsPanel.tsx، وقم بتحديث الاختبارات، وافتح طلب سحب بقائمة تحقق لمراقبة الجودة."
- يقوم الخادم بالتنسيق: قراءة حالة المستودع، وكتابة التغييرات (إذا قمت بتكوين أدوات الملفات المحلية)، ودفع فرع، وفتح طلب سحب باستخدام القالب الخاص بك، ونشر ملخص.
حديث حقيقي: حواجز الحماية التي تحتاجها بالفعل
- عمليات التشغيل التجريبي للقراءة فقط: اجعل Claude ينتج اختلافًا موحدًا (git diff) قبل الوصول للكتابة. ادمج بعد أن تفحصه بالعين.
- نصوص طلب السحب المقولبة: قم بتضمين ملاحظات المخاطر وخطط الاختبار وخطوات التوزيع. اجعل الروبوت يكمل القالب؛ اجعل البشر يراجعونه.
- قواعد التصنيف: قم بتطبيق التصنيفات تلقائيًا مثل ai-generated و needs-tests للحفاظ على الأمور قابلة للاكتشاف وصادقة.
- تسمية الفروع: تتطلب بادئة (ai/ أو bot/) مع قواعد حماية الفروع. تحتاج الروبوتات أيضًا إلى زي موحد.
وقت الحكايات: طلبت من الذكاء الاصطناعي "إصلاح خطأ المصادقة". "أصلحه" عن طريق إزالة المصادقة. عظيم للإنتاجية! فظيع لأي شيء آخر حرفيًا. حافظ على النطاقات ضيقة والمطالبات محددة واختبارات CI تعني.
من الصفر إلى طلب السحب: سيناريو واقعي من البداية إلى النهاية
السيناريو: إصلاح اختبار الارتعاش المتقطع في مشروع React
- تفتح مشكلة: "Debounce util: تتقشر على حدود 200 مللي ثانية في CI." يمكنك وضع علامة ai-pr عليه.
- مشغلات سير العمل. يبحث عن debounce.ts والاختبارات ذات الصلة.
- يقترح Claude اختلافًا: يقوم بتعديل المؤقتات باستخدام jest.useFakeTimers، ويضيف هامشًا في التأكيدات، ويحدث المستندات.
- يفتح الروبوت طلب سحب مع: العنوان والملخص والأساس المنطقي وخطة الاختبار وتقييم المخاطر.
- تقوم بمراجعة الاختلاف، ودفع: "حالة حافة عندما يكون التأخير = 0."
- تعلق @claude التعامل مع التأخير = 0 مع التدفق الفوري؛ إضافة اختبار. يتم إعادة تشغيل سير العمل، ويدفع التزامًا.
- تنجح CI. يمكنك الضغط والدمج. في مكان ما، يبكي اختبار متقطع "العم".
كيف تبدو المطالبات الجيدة (وما يجب تجنبه)
- رائع: "أضف تبديل الوضع المظلم إلى SettingsPanel.tsx؛ استمر في localStorage؛ قم بتحديث SettingsPanel.test.tsx؛ اتبع قواعد ESLint الخاصة بنا؛ قم بتعديل /src/ui/ و /src/utils/ فقط؛ 250 سطرًا كحد أقصى."
- Meh: "قم بتطبيق الوضع المظلم."
اجعله آمنًا: فحص سريع للأمن والامتثال
- نطاقات الرموز المميزة: استخدم repo:contents write فقط إذا لزم الأمر؛ تفضل pull_request write لإنشاء طلب السحب.
- القائمة المسموح بها للمستودع: قم بتأمين الروبوت على مستودع أو مؤسسة واحدة.
- التسجيل: تأكد من أن الروبوت يسجل إجراءاته ومطالباته (باستثناء الأسرار). سترغب في الحصول على دليل عندما "يحسن" Dockerfile الخاص بك.
- حماية الفروع: تتطلب موافقتين بشريتين لفروع ai/*.
استكشاف الأخطاء وإصلاحها: عندما لا يكون الروبوت روبوتًا
- لا يمكنه دفع الفروع: تحقق من أذونات Actions لـ contents: write وأن الرمز المميز الخاص بك لديه حق الوصول إلى repo write.
- يفتح طلبات سحب فارغة: منشئ السياق الخاص بك لا يسلمه الملفات الصحيحة. شدد منطق تحديد الملف الخاص بك.
- ينتهي الوقت في المستودعات الكبيرة: قم بتقييد السياق بالمسارات المتغيرة أو البيان. يصاب الذكاء الاصطناعي بعسر الهضم في المستودعات الأحادية التي تبلغ سعتها 10 جيجابايت، تمامًا مثل بقيتنا.
- يتجاهل قالب طلب السحب الخاص بك: تأكد من أن القالب موجود في .github/pull_request_template.md أو مرتبط في إعدادات المستودع الخاص بك.
متى تستخدم أي مسار
- استخدم GitHub Actions إذا كنت تريد طريقة سهلة لإنشاء طلبات سحب تلقائيًا من المشكلات أو التعليقات، مع حدوث كل شيء في GitHub.
- استخدم {MCP} إذا كنت تريد أن يعمل Claude في بيئتك المحلية أو عبر أدوات متعددة مع عناصر تحكم محددة للغاية.
تجدر الإشارة إلى: إذا كنت ترغب في إجراء فحص سريع للسلامة على سير العمل أو لإنشاء مطالبة بداية قوية، فيمكن Sider.AI مساعدتك في صياغة قوالب طلب السحب ومطالبات الحماية، ثم التكرار عليها باستخدام مقتطفات المستودع الحقيقية. إنه مثل وجود محرر متعصب يكتب التعليمات البرمجية بالفعل. ولا يسرق كرسي مكتبك. الأنماط الشائعة التي سترغب في نسخها
- تصنيفات طلب السحب المدعومة بالذكاء الاصطناعي و CODEOWNERS: توجيه طلبات السحب ai/* إلى مجموعة مراجعة تستمتع بالجدال مع الروبوتات.
- الالتزامات خطوة بخطوة: اطلب من Claude إنشاء التزامات صغيرة وذرية برسائل واضحة بدلاً من التزام ضخم واحد باسم "أشياء".
- وضع الاختبار أولاً: اجعل سير العمل يولد الاختبارات أولاً، ويشغل CI، ثم ينشئ التنفيذ. إنه أبطأ. إنه أفضل.
- الأعمال الروتينية بعد الدمج: أضف سير عمل لفتح مشكلة متابعة تلقائيًا للمستندات أو علامات الميزات أو التنظيف.
فحص تنافسي سريع
- يقوم بعض الأشخاص بتوصيل LLMs الأخرى بتدفقات GitHub مماثلة. إنها تعمل - لكن استدلال كود Claude Code واستعداده لقول "لست متأكدًا" يمكن أن يوفر لك ساعات من التخمين والتحقق. يحافظ تكامل GitHub Actions على وجوده حيث تحدث المراجعات بشكل طبيعي، ومسار {MCP} مرن للمستخدمين المتميزين.
قائمة التحقق من الإعداد لمدة 10 دقائق
- اختر مسارًا: GitHub Actions (أسرع) أو {MCP} (مزيد من التحكم).
- أنشئ الرمز المميز الخاص بك بأقل النطاقات.
- أضف سير العمل أو قم بتكوين خادم {MCP}.
- أنشئ منشئ سياق ضيق: قوائم الملفات والقيود والقواعد.
- أضف حماية الفروع والتصنيفات.
- اختبر تغييرًا صغيرًا أولاً. ادمج. احتفل. أخبر مدير مشروعك أنك "وسعت الإنتاجية".
مراجع سريعة لإبقائها في متناول اليد
- وثائق GitHub Actions الخاصة بـ Claude Code (الأنماط والمشغلات والأمثلة).
- دليل عملي للتكامل وأفضل الممارسات.
- شرح بالفيديو: طلبات السحب التي يتم إنشاؤها بالذكاء الاصطناعي من البداية إلى النهاية.
- خادم GitHub {MCP} للوصول الدقيق والمرخص.
- دليل خوادم {MCP} وأمثلة للإلهام.
ملخص ستيرن
أتمتة طلبات السحب باستخدام Claude Code لن تحل محل فريقك الهندسي. ستحل محل الأعمال الروتينية الأقل تفضيلاً لفريقك الهندسي. ابدأ بنطاقات ضيقة ومطالبات واضحة ومراجعات صارمة. دع الروبوت يتعامل مع السقالات بينما تتعامل أنت مع التفكير. ثم عد إلى الأشياء الممتعة - مثل حذف ملف utils2.ts الذي كنت تتجنبه أخيرًا لأنك تعرف أنه يربط التطبيق بشريط لاصق وأحلام.
اذهب الآن واجعل نفسك في المستقبل أقل غضبًا. وإذا خرج الروبوت عن السيطرة؟ أنت تعرف مكان وجود زر التراجع.
الأسئلة الشائعة
س 1: هل يمكن لـ Claude Code فتح طلبات سحب بمفرده؟
نعم. باستخدام GitHub Actions أو إعداد {MCP}، يمكن لـ Claude Code إنشاء فرع ودفع التغييرات وفتح طلب سحب بملخص وقائمة تحقق. حافظ على الأذونات ضيقة وتتطلب مراجعة بشرية حتى لا "تحسن" أمانك عن طريق إزالته.
س 2: ما هي الطريقة الأكثر أمانًا لربط GitHub بـ Claude Code؟
استخدم الرموز المميزة ذات النطاق الأدنى والقوائم المسموح بها للمستودع وحماية الفروع. سواء كنت تستخدم Actions أو {MCP}، قم بتمكين عمليات التشغيل التجريبي وتتطلب اجتياز الاختبارات قبل دمج أي طلب سحب تم إنشاؤه بواسطة الذكاء الاصطناعي.
س 3: كيف أمنع طلبات السحب المدعومة بالذكاء الاصطناعي من لمس المستودع الأحادي بأكمله؟
حدد نطاق السياق مع الدلائل المدرجة في القائمة المسموح بها وبيان الملف وحدد عدد الملفات لكل تشغيل. المطالبات الجيدة تساعد أيضًا - كن محددًا بشأن المسارات وحدود الحجم.
س 4: لماذا طلبات السحب المدعومة بالذكاء الاصطناعي فارغة أو ذات جودة منخفضة؟
قد يكون منشئ السياق الخاص بك يزود Claude بالملفات الخاطئة أو القليل جدًا من التفاصيل. قدم أهدافًا وقيودًا وتوقعات اختبار واضحة - وفكر في تدفق من خطوتين: قم بإنشاء الاختبارات أولاً، ثم التنفيذ.
س 5: هل يجب علي استخدام GitHub Actions أو {MCP} لـ Claude Code؟
إذا كنت تريد أتمتة سريعة وأصلية للمستودع لطلبات السحب والمراجعات، فاستخدم GitHub Actions. إذا كنت بحاجة إلى تحكم محلي أو أدوات مخصصة أو أذونات دقيقة، فإن {MCP} يمنحك مزيدًا من القوة - مع إعداد أكثر قليلاً.
