Claude Code: سير عمل Git و إجراءات جيتهب

آخر تحديث: 2026-08-31

Claude Code لا يكتب الكود فقط — بل يتكامل مع سير عمل Git الخاص بك، من اتفاقيات الالتزام إلى مراجعات طلبات السحب، ومن تكامل CI إلى الإصلاحات الآلية.

💡 نصيحة: جوهر تكامل سير عمل Git هو "الإنسان في الحلقة" — Claude Code يساعد، والإنسان يقرر. الأتمتة (CI/CD) تستخدم وضع headless؛ والتطوير اليومي يستخدم الوضع التفاعلي.

📋 المتطلبات السابقة: الفصل 22 - متغيرات البيئة وتهيئة التطوير

1. ما ستتعلمه


2. تكامل سير عمل Git

(1) أوامر تكامل Git الشائعة

العملية الأمر الوصف
التزام التغييرات /commit توليد رسالة التزام تلقائياً
عرض التغييرات /diff عرض تعديلات الجلسة الحالية
التراجع عن عملية /undo التراجع عن آخر عملية

▶ مثال 1: سير عمل Git بمساعدة Claude Code

TEXT 📖 للعرض فقط
> Complete user registration feature development

Claude Code: Created files, tests pass ✅

> /commit

Claude Code auto-generates:
  feat: add user registration service

  - Create registration.service.ts with email/password signup
  - Add POST /api/register endpoint
  - Add input validation
  - Write 6 unit tests (all passing)

  Allow commit? [y/n] y
  ✅ Committed: feat: add user registration service

3. أتمتة اتفاقيات الالتزام

(1) تكامل Conventional Commits

نوع التغيير البادئة مثال
ميزة جديدة feat: feat: add user registration
إصلاح fix: fix: token refresh on expiry
إعادة هيكلة إعادة هيكلة: إعادة هيكلة: extract التحقق logic
اختبار test: test: add registration tests
توثيق docs: docs: update توثيق API
أسلوب style: style: fix indentation
تهيئة chore: chore: update dependencies

4. تكامل إجراءات جيتهب

(1) المراجعة التلقائية لطلبات السحب

YAML
# .github/workflows/ai_review.yml
name: AI Code Review
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  ai-review:
    runs-on: ubuntu-latest
    permissions:
      pull-requests: write
    steps:
      - uses: actions/checkout@v4
      - name: Install Claude Code
        run: npm install -g @anthropic-ai/claude-code
      - name: AI Review
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          claude --headless --output json \
            "Review this PR: security, performance, style, test coverage" > review.json
      - name: Post Review
        run: |
          COMMENT=$(jq -r '.result.summary' review.json)
          gh pr comment ${{ github.event.pull_request.number }} --body "$COMMENT"
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

(2) الإصلاح التلقائي لمشاكل الفحص

YAML
# .github/workflows/auto-fix.yml
name: Auto Fix Lint
on:
  push:
    branches: [main]

jobs:
  auto-fix:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Install Claude Code
        run: npm install -g @anthropic-ai/claude-code
      - name: Fix Lint
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          claude --headless --allowed-tools Read,Write \
            "Run npm run lint, fix all auto-fixable issues"
      - name: Commit Fixes
        run: |
          git config user.name "Claude Code Bot"
          git add -A
          git diff --staged --quiet || git commit -m "style: auto-fix lint issues"
          git push

5. ممارسة مراجعة طلبات السحب

(1) مراجعة مزدوجة: إنسان + AI

البُعد مراجعة AI مراجعة إنسانية
الثغرات الأمنية ✅ بارع فيها مكملة
أسلوب الكود ✅ بارع فيها غير مطلوبة
الأداء ✅ عام السيناريوهات الحرجة
منطق العمل ❌ ضعيف ✅ أساسي
تصميم البنية ❌ ضعيف ✅ أساسي

❓ أسئلة شائعة

س هل يمكن لـ Claude Code دمج طلبات السحب تلقائياً؟
ج تقنياً نعم لكن غير موصى به. Claude Code في CI يراجع ويقترح فقط؛ وقرارات الدمج للبشر.
س من يدفع تكاليف API لـ إجراءات جيتهب؟
ج يستخدم مفتاح API في Secrets الخاص بالمستودع؛ والتكاليف يتحملها صاحب المفتاح. يُنصح بمفتاح CI منفصل بحدود حصة.
س كيف أتجنب الحلقات اللانهائية في CI؟
ج التزامات الإصلاح التلقائي لا يجب أن تُفعّل سير عمل جديد. أضف if: github.actor != 'claude-code-bot' في YAML.
س هل يعمل مع GitLab CI؟
ج نعم. Claude Code أداة CLI؛ وأي بيئة CI يمكنها تشغيل npm يمكنها استخدامه.

📖 ملخص


📝 تمارين

  1. أساسي (⭐): استخدم /commit لالتزام التغييرات، وتحقق من جودة الرسالة المُولّدة تلقائياً.
  2. متوسط (⭐⭐): هيّئ إجراءات جيتهب لمراجعة أمنية تلقائية عند طلبات السحب.
  3. متقدم (⭐⭐⭐): ابنِ خط أنابيب مراجعة AI كامل (أمان+جودة+تغطية) مع تعليقات تلقائية على طلبات السحب.
Web-Tutorial.com

فريق Web-Tutorial التقني

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

100%