AI CodeOps

مراجعة طلبات السحب من Claude Code عبر بوابات الجودة

Matt · · آخر تحديث · مدة القراءة: ⁨9⁩ دقيقة · الأدلة

مرّر عمل Claude Code عبر جلسات AI CodeOps الخاضعة للبوابات من خلال MCP، واجعل فحص بوابة الإصدار مطلوبا على طلب السحب، وامنع الدفع الذي يلتف عليه.

لكي تضع طلبات السحب التي يصنعها Claude Code خلف بوابات الجودة، اجعل Claude Code يبدأ جلسات AI CodeOps عبر خادم MCP بدلا من أن يكتب التغيير ويدفعه بنفسه، ثم اجعل بوابة الإصدار في AI CodeOps فحصا مطلوبا على طلب السحب. فتختبر الجلسة التغيير وتراجعه، ويوافق عليه شخص ثان، ويبقي الفحص المطلوب زر الدمج مقفلا إلى أن تسمح البوابة.

المشكلة: طلبات سحب سريعة من الوكلاء، ومراجعة بشرية بطيئة

يجيد Claude Code تحويل جملة إلى فروقات. وما يقف عادة بين تلك الفروقات والفرع الرئيسي لديك هو «مطور يلقي عليها نظرة سريعة»، وهذا يصمد إلى أن يرتفع الحجم. فالوكيل يستطيع أن يفتح في صباح واحد طلبات سحب أكثر مما يستطيع فريق أن يقرأه بعناية في يوم كامل، والقراءة المتأنية هي الجزء الذي يحذف أولا.

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

تقرر بوابة الإصدار في AI CodeOps بناء على أدلة سجلتها بنفسها: الجلسة التي كتبت التغيير، ومراجعة الذكاء الاصطناعي لفروقاته، وتشغيل الاختبار في بيئتها المعزولة، والموافقة. وتجد هذه الأدلة عن طريق طلب السحب الذي فتحته الجلسة. ولا تراقب البوابة مستودعاتك بحثا عن طلبات سحب فتحت في مكان آخر. فإذا كتب Claude Code تغييرا على جهازك ثم دفعته أنت وفتحت طلب سحب، فلا يعرف AI CodeOps عنه شيئا. واسأل البوابة عن طلب السحب ذاك فتجيب allowed: false مع الرسالة "No workflow runs found for …". وهذه هي الإجابة الصحيحة: فليس لديها ما تحكم عليه، فترفض.

وهذا يحدد التصميم. إذا أردت أن يكون عمل Claude Code خلف البوابة، فيجب أن يمر العمل عبر جلسة AI CodeOps. يبقى Claude Code الواجهة التي تكتب فيها، أما الكتابة والاختبار والمراجعة فتجري في الجلسة على المنصة، وهي التي تفتح طلب السحب.

الإعداد: اربط المستودع، واختر البوابات، واجعل الفحص مطلوبا

اربط المستودع. في AI CodeOps، اربط حسابك على GitHub من Configure → Settings → Git Providers (إعداد GitHub)، وأنشئ مشروعا بعنوان المستودع من Plan → Projects. والجلسات على ذلك المشروع تكتب على لقطة من المستودع وتفتح طلبات السحب فيه. وتشرح صفحة تكامل GitHub ما يفعله AI CodeOps بالمستودع.

اختر البوابات. افتراضيا ترفض بوابة الإصدار التغيير إذا بقيت ملاحظة بخطورة high أو critical مفتوحة، أو فشل تشغيل اختبار، أو لم تكن لجلسة غيرت الكود نتيجة اختبار فيها أعداد، أو فشل سير عمل تعتمد عليه أو لم ينته أي تشغيل له، أو لم تكتمل مراجعة الذكاء الاصطناعي. وفي استدعاء CI يمكنك إضافة blockingSeverity و requiredWorkflows و minCoveragePct. والحد الأدنى للتغطية يحتاج إلى رقم للتغطية: فإذا لم يبلغ أي تشغيل اختبار على التغيير عن التغطية، ترفض البوابة، لأنها لا تستطيع التحقق من الحد الأدنى. والقواعد كاملة في صفحة بوابات الجودة.

اجعل فحص AI CodeOps مطلوبا. سؤال البوابة من Claude Code مفيد، لكنه استشاري: فما زال بإمكان أحد أن يضغط زر Merge. والفرض مكانه خدمة استضافة Git. وهذا هو لـ GitHub، بسير عمل بسيط ودون Action إضافي يحتاج إلى تثبيت:

# .github/workflows/aicodeops-gate.yml
name: AI CodeOps gate
on:
  pull_request:

permissions:
  contents: read

jobs:
  gate:
    if: startsWith(github.head_ref, 'codeops/run-')
    runs-on: ubuntu-latest
    steps:
      - name: Ask the AI CodeOps release gate
        env:
          AICODEOPS_API_KEY: ${{ secrets.AICODEOPS_API_KEY }}
          PR_URL: ${{ github.event.pull_request.html_url }}
        run: |
          jq -n --arg pr "$PR_URL" '{pullRequestURL: $pr}' > request.json
          curl -sS --fail-with-body -X POST "https://console.aicodeops.dev/api/release/check" \
            -H "Authorization: Bearer $AICODEOPS_API_KEY" \
            -H "Content-Type: application/json" \
            --data @request.json -o gate.json
          jq -r '.summary' gate.json
          jq -r '.reasons[]' gate.json
          jq -e '.allowed == true' gate.json > /dev/null

أضف المفتاح سرا في المستودع باسم AICODEOPS_API_KEY. واستخدم مفتاحا منفصلا لـ CI، لا المفتاح الذي في محررك. فالفحص لا يحتاج إلا إلى workspace:read، وحيث تتيح خطتك تحديد نطاق المفاتيح يمكنك قصر المفتاح على فحص بوابة الإصدار.

وهناك بعض التفاصيل المهمة هنا:

  • اقرأ allowed، لا رمز الحالة. تجيب نقطة النهاية بالرمز 200 في الحكمين كليهما. والسطر الأخير يجعل الخطوة تفشل ما لم تكن allowed بقيمة true.
  • إنها تغلق عند الخطأ. المفتاح المفقود أو الخاطئ يحصل على 401 أو 403، ويحول --fail-with-body ذلك إلى خطوة فاشلة. وإذا تعطل التقييم نفسه، تجيب واجهة API بالقيمة allowed: false مع الرسالة "Evaluation failed". وأكثر من 60 فحصا في الدقيقة لمساحة العمل يحصل على 429، وهذا أيضا يفشل الخطوة، فأعد تشغيلها.
  • الأداتان jq و curl موجودتان أصلا. صورة المشغل ubuntu-latest لدى GitHub تأتي بالاثنتين، فلا شيء يحتاج إلى تثبيت.

والسطر if: خيار ينبغي أن تتخذه عن قصد. فهو لا يشغل البوابة إلا على الفروع التي فتحها AI CodeOps. وتقول صفحة استكشاف أخطاء الفحوص المطلوبة لدى GitHub إن المهمة التي يتخطاها شرط على مستوى المهمة تبلغ "Success". فيبقى طلب السحب الذي يفتحه إنسان قابلا للدمج وفق قواعدك المعتادة، ولا يمكن دمج طلب سحب من AI CodeOps إلى أن تسمح البوابة. ولا تستبدل بالسطر if: مرشحا للفروع تحت on:. فالصفحة نفسها تقول إن الفحوص التي يتخطاها ترشيح الفروع أو المسارات تبقى "Pending" وتمنع الدمج.

وإذا حذفت if: تماما، احتاج كل طلب سحب إلى جلسة AI CodeOps وراءه. وهذه سياسة صالحة لمستودع لا يغيره إلا الوكلاء، لكنها تمنع كل طلب سحب يفتحه إنسان، فاتخذ هذا القرار عن وعي.

وأخيرا، اجعل الفحص مطلوبا. في قاعدة حماية الفروع أو مجموعة القواعد الخاصة بالفرع main، اشترط نجاح فحوص الحالة واختر الفحص gate. واشترط أيضا طلب سحب قبل الدمج، فلا يصل شيء إلى main دون أن يمر بطلب سحب. ويغطي مقال مجموعات قواعد GitHub لوكلاء الذكاء الاصطناعي بقية مجموعة القواعد.

استخدام خادم MCP من AI CodeOps داخل Claude Code

يشغل AI CodeOps خادم MCP بعيدا على العنوان https://console.aicodeops.dev/mcp. وهو يتحدث طريقة النقل Streamable HTTP، ويقبل مفتاح API لمساحة العمل رمزا من نوع Bearer.

أنشئ مفتاحا من Configure → API Keys. يبدأ المفتاح بالبادئة sk- ويعرض مرة واحدة. وأداتان تحتاجان إلى أكثر من صلاحية القراءة، ولا يحصل عليهما المفتاح غير محدد النطاق افتراضيا:

  • start_session تستهلك ميزانية النماذج، فلا تعمل إلا لمفتاح يذكرها نطاقه. اختر Scope على المفتاح، وضع علامة على Start sessions from the MCP server (/mcp).
  • get_evidence_pack تصدّر سجل التدقيق، فتحتاج أيضا إلى وضع علامة على Evidence packs from the MCP server (/mcp).

أما الأدوات السبع الأخرى (list_projects و get_session و check_release_gate و list_findings و list_builds و get_build و list_saved_builds) فتقرأ فقط. والمفتاح يتصرف دائما باسم العضو الذي أنشأه، وبدوره الحالي. فمفتاح المشاهد يستطيع القراءة ولا شيء غيرها، أيا كان ما يقوله نطاقه.

ثم أضف الخادم. هذا هو الأمر الوارد في دليل خادم MCP، بالصيغة التي تعطيها وثائق MCP في Claude Code لخادم HTTP بعيد مع ترويسة (جرى التحقق منها في 24 أكتوبر 2026):

claude mcp add --transport http aicodeops https://console.aicodeops.dev/mcp \
  --header "Authorization: Bearer $AICODEOPS_API_KEY"

هذا يخزن الخادم في النطاق المحلي الافتراضي، في ~/.claude.json، للمشروع الحالي فقط. أما للفريق، فملف .mcp.json بنطاق المشروع داخل المستودع أفضل، لأن Claude Code يوسع متغيرات البيئة في url و headers الخاصين بالخادم البعيد. فيودع الجميع الملف نفسه، ويحتفظ كل منهم بمفتاحه في واجهة الأوامر لديه:

{
  "mcpServers": {
    "aicodeops": {
      "type": "http",
      "url": "https://console.aicodeops.dev/mcp",
      "headers": { "Authorization": "Bearer ${AICODEOPS_API_KEY}" }
    }
  }
}

يطلب Claude Code من كل شخص الموافقة على الخوادم ذات نطاق المشروع الواردة في .mcp.json قبل استخدامها. شغّل /mcp داخل Claude Code، فينبغي أن يظهر aicodeops متصلا بتسع أدوات.

جولة عملية: طلب سحب واحد من الموجه حتى الدمج

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

الأداة list_projects تعيد مشاريع مساحة العمل ومستودعاتها. فيختار Claude Code معرف المشروع api.

الأداة start_session تبدأ جلسة بمهمتك وذلك المشروع. ومن دون الوسيط workflow تشغل plan-build-review-test. ويمكنك تسمية سير عمل آخر، مثل security-sensitive-change، الذي يضيف تحليلا للمخاطر قبل التغيير وتدقيقا للفروقات بعده. ويعيد الاستدعاء معرف الجلسة ورابطا إليها في لوحة التحكم. ويحتسب أيضا من ميزانية مساحة العمل ومن حد العمل الجاري للوكلاء، تماما كما تحتسب الجلسة التي تبدأ من المتصفح.

ومن هنا يجري العمل على المنصة، لا على جهازك:

  1. يخطط الوكلاء للتغيير ويكتبونه على لقطة من المستودع، وتسلم كل خطوة مخرجاتها إلى التالية (ويشرح دليل أنماط الأنظمة متعددة الوكلاء عمليات التسليم هذه).
  2. تشغل خطوة التحقق (verify) اختبارات مشروعك على الشجرة المقترحة في بيئة معزولة. تثبت أولا التبعيات الموجودة في المستودع. ثم تقطع البيئة المعزولة عن الشبكة، وعندها فقط تكتب تعديلات الذكاء الاصطناعي وتشغل. وإذا تعذر التأكد من أن البيئة المعزولة غير متصلة، لا يشغل التغيير أصلا. وإذا مس التغيير ملف تعريف للتبعيات، يعمل التثبيت مرة أخرى والشبكة ما زالت مغلقة، فلا يمكن جلب حزمة لم تكن موجودة من قبل، وتسجل مجموعة الاختبارات على أنها متخطاة لا مشغلة.
  3. يقرأ مراجع بالذكاء الاصطناعي الفروقات ويسجل ملاحظات مع درجة خطورتها. والرد الذي ليس قائمة مقروءة يعد مراجعة فاشلة، وتحتجز البوابة التغيير.
  4. يفتح طلب موافقة تحت Review & Gate → Approvals.

الأداة get_session هي ما يستطلعه Claude Code دوريا. وتعيد الحالة والخطوات، ومتى وجدا، طلب السحب وسجل التغيير الخاص به.

والموافقة هي الخطوة التي يتخطاها الناس في الإعدادات الأخرى، فيحسن أن نوضحها. بدأت الجلسة بمفتاحك، فأنت من بدأها. ومتى صار في مساحة العمل شخص ثان يستطيع الموافقة، لم تعد موافقتك تحتسب. فيجب أن ينظر شخص آخر في الفروقات. وحين يوافق، يفحص AI CodeOps التغيير في ضوء بوابة الجودة، ويفتح طلب السحب على فرع باسم codeops/run-<id>. والرفض مسموح دائما، ورفض واحد يوقف التغيير.

الأداة check_release_gate تجيب عن سؤال هل يجوز إطلاق طلب السحب، مع الأسباب. وهي الفحص نفسه الذي في سير عمل CI أعلاه، بالقيم الافتراضية والخيارات نفسها.

الأداة get_evidence_pack تعيد السجل الموقّع للتغيير: الموجه، والنموذج، والتشغيلات، والملاحظات، والاختبارات، والموافقات، موقّعة بخوارزمية Ed25519 وقابلة للتحقق على /evidence/verify. وتصديرها يسجل هو نفسه في سجل التدقيق.

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

نصائح

امنع الوكيل المحلي من الالتفاف على البوابة. الثغرة الأخيرة هي Claude Code نفسه. ففي جلسة عادية على جهازك يستطيع أن يشغل git push و gh pr create كما تستطيع أنت. وإذا فعل، حصلت بالضبط على طلب السحب غير الخاضع للبوابة الذي صمم هذا الإعداد لتجنبه.

وتستطيع قواعد الصلاحيات في Claude Code رفض هذه الأوامر. أودع هذا في .claude/settings.json داخل المستودع:

{
  "permissions": {
    "deny": ["Bash(git push *)", "Bash(gh pr create *)", "Bash(gh pr merge *)"]
  }
}

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

وكن واضحا بشأن طبيعة ذلك (جرى التحقق من الوثائق في 24 أكتوبر 2026). فالوثائق نفسها تقول إن قاعدة Bash تطابق نص الأمر الذي يكتبه Claude، فالقاعدة Bash(git push *) لا تطابق git -C . push، وتقرر صراحة أن مثل هذه القاعدة «ليست حدا أمنيا حول البرنامج». تعامل مع قائمة الرفض على أنها حزام أمان للحالة الشائعة. أما الحد الفاصل فعلى خدمة استضافة Git: فرع main محمي، وطلب سحب مطلوب، ومراجعات مطلوبة لطلبات السحب البشرية، والفحص المطلوب gate لطلبات السحب من AI CodeOps.

اعرف ما لا يفعله هذا الإعداد.

  • لا يراجع طلبات السحب التي لم يفتحها AI CodeOps. التغيير الذي كتبته محليا بـ Claude Code ودفعته بنفسك هو تغييرك أنت. تسري عليه مراجعتك البشرية المعتادة، ولا رأي للبوابة فيه.
  • لا يستخدم سطور التذييل في الإيداعات إشارة. يستطيع Claude Code إضافة سطر نسبة إلى الإيداعات وطلبات السحب، لكن إعداد لديه يستطيع تغييره أو إخفاءه. والقاعدة المبنية على سطر تذييل قاعدة يستطيع الوكيل إيقافها.
  • لا يجعل مراجعة الذكاء الاصطناعي معصومة من الخطأ. المراجعة نموذج يقرأ فروقات. ولهذا تقف بجانب تشغيلات اختبار حقيقية وشخص ثان، لا بدلا منهما.

استخدم مفتاحا ثانيا لـ CI. مفتاح المحرر يستطيع بدء الجلسات؛ أما مفتاح CI فلا يحتاج إلا إلى قراءة البوابة. فإذا تسرب أحدهما، ألغيته دون أن تعطل الآخر.

أما الاتجاه المعاكس، أي ربط خوادم MCP الخاصة بك بالجلسات، ففي صفحة تكامل MCP.

أهم النقاط

  • لا تحكم بوابة AI CodeOps إلا على التغييرات التي صنعتها جلسة AI CodeOps، فمرّر عمل Claude Code عبر الجلسات من خلال MCP.
  • اجعل بوابة الإصدار فحصا مطلوبا على main، ولا تشغلها إلا على فروع codeops/run- بشرط if: على مستوى المهمة.
  • اقرأ allowed في إجابة البوابة، لا حالة HTTP، ودع كل خطأ يفشل الخطوة.
  • لا يستطيع من بدأ الجلسة الموافقة عليها وحده متى صار هناك شخص آخر يستطيع المراجعة.
  • قواعد الرفض في Claude Code حزام أمان؛ أما حماية الفروع والفحص المطلوب فهما الحد الفاصل.

الأسئلة الشائعة

هل يستطيع AI CodeOps تطبيق بوابته على طلب سحب دفعه Claude Code من جهازي؟

لا. تحكم بوابة الإصدار على الأدلة المأخوذة من جلسات AI CodeOps، فطلب السحب الذي لم تفتحه جلسة يحصل على allowed بقيمة false مع الرسالة "No workflow runs found". اجعل Claude Code يبدأ جلسة بدلا من أن يدفع التغيير بنفسه.

هل ما زال شخص يراجع طلبات السحب التي يصنعها Claude Code؟

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

هل توقف قواعد الرفض في Claude Code كل عملية git push؟

لا. فقاعدة Bash تطابق نص الأمر الذي يكتبه Claude، فالصيغة الأخرى للدفع لا تطابقها. تعامل مع قائمة الرفض على أنها حزام أمان، واعتمد على حماية الفروع والفحص المطلوب حدا فاصلا.