Claude Code: سير عمل Git و إجراءات جيتهب
آخر تحديث: 2026-08-31
Claude Code لا يكتب الكود فقط — بل يتكامل مع سير عمل Git الخاص بك، من اتفاقيات الالتزام إلى مراجعات طلبات السحب، ومن تكامل CI إلى الإصلاحات الآلية.
💡 نصيحة: جوهر تكامل سير عمل Git هو "الإنسان في الحلقة" — Claude Code يساعد، والإنسان يقرر. الأتمتة (CI/CD) تستخدم وضع headless؛ والتطوير اليومي يستخدم الوضع التفاعلي.
📋 المتطلبات السابقة: الفصل 22 - متغيرات البيئة وتهيئة التطوير
1. ما ستتعلمه
- تعاون Claude Code مع Git
- أتمتة اتفاقيات الالتزام
- تكامل إجراءات جيتهب
- المراجعة التلقائية لطلبات السحب
- Claude Code في خطوط CI/CD
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 يمكنها استخدامه.
📖 ملخص
/commitيُولّد تلقائياً رسائل بتنسيق Conventional Commits- إجراءات جيتهب يستخدم وضع headless لتكامل Claude Code
- المراجعة التلقائية لطلبات السحب: الأمان، الأداء، الأسلوب؛ الإنسان: العمل، البنية
- Claude Code في CI يقترح فقط، لا يقرر؛ الإنسان في الحلقة
- انتبه للحلقات اللانهائية في CI مع التزامات الإصلاح التلقائي
📝 تمارين
- أساسي (⭐): استخدم
/commitلالتزام التغييرات، وتحقق من جودة الرسالة المُولّدة تلقائياً. - متوسط (⭐⭐): هيّئ إجراءات جيتهب لمراجعة أمنية تلقائية عند طلبات السحب.
- متقدم (⭐⭐⭐): ابنِ خط أنابيب مراجعة AI كامل (أمان+جودة+تغطية) مع تعليقات تلقائية على طلبات السحب.