نصائح سير العمل

سير عمل تطوير فعّال باستخدام Claude Code لتعزيز إنتاجية الفريق

تحتاج مفتاح API؟ أنشئ حسابًا ←·نقاط النهاية وعناوين Base URL ←

يغطي هذا الدليل كيفية دمج Claude Code في سير عمل التطوير اليومي لديك، من الكفاءة الشخصية إلى تعاون الفريق، وإنشاء عمليات تطوير فعّالة بمساعدة الذكاء الاصطناعي.

سير عمل التخطيط والتنفيذ¶

النمط الأكثر فعالية في Claude Code هو التخطيط أولًا، والتنفيذ لاحقًا—تجنّب أن يكتب الذكاء الاصطناعي الكود مباشرة.

التدفق الأساسي¶

1. Analyze Requirements → 2. Create Plan → 3. Confirm Plan → 4. Execute Step by Step → 5. Verify Results

الخطوات العملية¶

الخطوة 1: اجعل Claude يفهم المتطلبات

> Read the code in @src/services/ directory and understand the existing architecture.
> Don't write any code, just analyze.

الخطوة 2: أنشئ خطة تنفيذ

> Based on your understanding of the existing code, create a detailed implementation plan for "user permission management".
> Include: file changes, new files, dependencies, risk points.

الخطوة 3: أكّد الخطة وعدّلها

راجع خطة Claude واقترح تعديلات:

> In step 3 of the plan, I want to use Redis cache instead of memory cache. Please adjust the plan.

الخطوة 4: نفّذ خطوة بخطوة

> Now execute step 1 of the plan: create the permission model.

بعد إكمال كل خطوة، تحقّق من النتائج قبل المتابعة.

سير عمل فرع الميزة¶

أفضل ممارسات فروع Git¶

# 1. Create feature branch
git checkout -b feature/user-permissions

# 2. Navigate to project and start Claude Code
cd your-project && claude

# 3. Commit frequently during development
> Commit this change  # First commit
# Continue developing...
> Commit this change  # Second commit

# 4. Feature complete, create PR
> Create a PR description for the current branch, summarizing all commit changes

نصائح حول وتيرة الإيداع¶

• إيداعات صغيرة: أجرِ إيداعًا بعد كل نقطة ميزة مستقلة

• رسائل الإيداع: اطلب من Claude إنشاء رسالة مناسبة من فرق التغييرات (يمكن للمشاريع التي لديها أمر /commit مخصص استخدام ذلك)

• تجنّب الإيداعات الكبيرة: لا تجمع تغييرات كثيرة جدًا قبل الإيداع

سير عمل مراجعة الكود¶

المراجعة الذاتية¶

قبل إرسال طلب سحب، اطلب من Claude المراجعة:

> /review
> Focus on: security, performance, code style

مراجعة كود الآخرين¶

# Get PR changes
gh pr diff 123 | claude "Review this PR, focus on:
1. Logic correctness
2. Edge case handling
3. Error handling
4. Code maintainability"

عملية المراجعة متعددة المراحل¶

بالنسبة لطلبات السحب المعقدة، استخدم مراجعة منظمة:

> Phase 1: Check if architecture design is reasonable
> Phase 2: Check if implementation matches design
> Phase 3: Check if test coverage is sufficient
> Phase 4: Check if documentation is complete

سير عمل التطوير المدفوع بالاختبار¶

التطوير المدفوع بالاختبار مع Claude Code¶

1. Write Tests → 2. Run Tests (Fail) → 3. Write Code → 4. Run Tests (Pass) → 5. Refactor

الخطوات العملية¶

الخطوة 1: تعريف الاختبارات

> Write test cases for user registration, covering:
> - Normal registration
> - Invalid email format
> - Weak password
> - User already exists
> Write tests first, don't implement the feature.

الخطوة 2: التحقق من فشل الاختبارات

npm test  # Expected: tests fail

الخطوة 3: تنفيذ الميزة

> Now implement the code to make all tests pass.

الخطوة 4: التحقق وإعادة الهيكلة

npm test  # Expected: tests pass

> Tests pass. Now refactor the code for better readability without breaking tests.

سير عمل تصحيح الأخطاء¶

تصحيح الأخطاء المنظم¶

1. Reproduce Issue → 2. Gather Information → 3. Analyze Cause → 4. Verify Hypothesis → 5. Fix Issue

الخطوات العملية¶

الخطوة 1: وصف المشكلة

> Issue: After login, clicking "My Orders" shows blank page
> Expected: Display user's order list
> Steps to reproduce: Login → Click "My Orders"

الخطوة 2: جمع المعلومات

> Analyze these files to find possible issues:
> @src/pages/MyOrders.tsx
> @src/services/OrderService.ts
> @src/api/orders.ts

الخطوة 3: تحليل السجلات

# Collect error logs
cat app.log | claude "Analyze these logs, find errors related to the orders page"

الخطوة 4: الإصلاح والتحقق

> Based on the analysis, fix the issue in OrderService
> After fixing, I'll test to verify

سير عمل تعاون الوكلاء الفرعيين¶

المعالجة المتوازية¶

استفد من الوكلاء الفرعيين لمعالجة المهام على نحو متوازٍ:

> Execute these tasks simultaneously:
> 1. Use Explore agent to analyze project structure
> 2. Use Plan agent to design new feature approach

الأدوار المتخصصة¶

تختلف نقاط قوة الوكلاء الفرعيين:

سير عمل التكامل مع IDE¶

التكامل مع VS Code¶

1. ثبّت إضافة Claude Code لـ VS Code

2. استخدم Cmd+Esc / Ctrl+Esc للتبديل بسرعة

3. حدّد الشيفرة في المحرر ثم استدعِ Claude

التعاون بين الطرفية وIDE¶

Terminal (Claude Code)          IDE (VS Code)
        ↓                           ↓
   Analyze, Plan              Manual adjustments, reading
        ↓                           ↓
   Generate Code  ←─────────→   View diff, test
        ↓                           ↓
   Commit Code                  Continue development

سير عمل التعاون ضمن الفريق¶

توحيد CLAUDE.md¶

شارك إعدادات CLAUDE.md بين أفراد الفريق:

# Team Development Standards

## Code Style

- ESLint config: .eslintrc.js
- Prettier config: .prettierrc

## Git Standards

- Branch naming: feature/xxx, fix/xxx, hotfix/xxx
- Commit format: type(scope): description

## Testing Requirements

- Unit test coverage > 80%
- E2E tests cover core flows

قوالب طلبات السحب¶

اطلب من Claude استخدام قوالب موحدة لطلبات السحب:

> Create PR description using this template:
> ## Changes
> ## Test Plan
> ## Screenshots (if UI changes)
> ## Checklist

قائمة تحقق سير العمل¶

قبل بدء مهمة جديدة¶

• [ ] أنشئ فرع ميزة

• [ ] استخدم /clear لمسح السياق

• [ ] اطلب من Claude فهم الشيفرة الموجودة أولًا

• [ ] أنشئ خطة تنفيذ

أثناء التطوير¶

• [ ] نفّذ خطوة بخطوة، وتحقّق من كل خطوة

• [ ] اجعل الالتزامات صغيرة، واطلب من Claude تكرار الالتزام

• [ ] راقب السياق باستخدام /context

• [ ] استخدم /compact عند الحاجة

قبل الإرسال¶

• [ ] شغّل /review للمراجعة الذاتية

• [ ] شغّل جميع الاختبارات

• [ ] تحقّق من أخطاء lint

• [ ] أنشئ وصف طلب السحب

الخيارات التي يعتمد عليها سير العمل أكثر من غيرها¶

حتى 2026-10-15، وفقًا لوثائق Claude Code:

حدّان على التراجع: تقول الوثائق إن لقطات الملفات تُحفظ لأحدث 100 نقطة تحقق في الجلسة، وتُنظّف اللقطات افتراضيًا بعد نحو 30 يومًا من آخر مرة تحفظ فيها الجلسة لقطة، وبعد ذلك قد يفشل التراجع مع ظهور No files were restored؛ للاحتفاظ بها مدة أطول، عدّل cleanupPeriodDays.

ملاحظات عند تشغيل سير العمل هذه على QCode¶

• التزامن: تتيح الخطة الشخصية أو باقة الدفع حسب الاستخدام 5 طلبات متزامنة لكل مفتاح API (و10 على Ultimate؛ راجع الأسئلة الشائعة). وقد يؤدي تشغيل عدة نسخ من Claude Code، أو كثير من الوكلاء الفرعيين بالتوازي، إلى بلوغ الحد أولًا، وهو ما يظهر عادةً على شكل 429.
• الجلسات الطويلة: غالبًا ما تطول جلسات التخطيط ثم التنفيذ، وقرب حد نافذة السياق سترى E015 / 429. شغّل /compact أولًا وأعد تشغيل الجلسة إذا لم ينجح ذلك؛ راجع إدارة السياق.
• توزيع العمل بين النماذج: استخدم نموذجًا أقوى للتخطيط والمراجعة، وclaude-sonnet-5 للتعديلات الكبيرة، وبدّل بينها بـ/model. يحتسب QCode الفاتورة لكل token؛ وأسعار كل نموذج على qcode.cc/models.

الأخطاء الشائعة وكيفية استكشافها وإصلاحها¶

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

هل يجب أن أخطط دائمًا قبل التنفيذ؟¶

يمكن تنفيذ التغييرات الصغيرة مباشرة. أما المهام التي تمس عدة ملفات، أو التي يكون فيها الخطأ مكلفًا، فاطلب منه أن يقترح خطة في وضع التخطيط أولًا ثم ينفّذها بعد تأكيدك؛ وهذا يعني عادةً إعادة عمل أقل.

كم مرة يجب أن أشغّل /compact؟¶

لا يوجد إيقاع ثابت. نفّذ الضغط عند انتهاء مرحلة، أو عندما يُظهر /context أن الاستخدام عند 70% إلى 80%، بدلًا من انتظار تجاوز الحد.

كيف أتراجع بعد خطأ؟¶

بالنسبة إلى الشيفرة، استخدم git و/rewind معًا: نفّذ commit على خطوات صغيرة، واستخدم /rewind للتراجع داخل الجلسة. ونفّذ commit عند النقاط المهمة قبل أن تدع Claude يتابع.

هل تتأثر عدة جلسات متوازية لمهام مختلفة بعضها ببعض؟¶

محادثاتها مستقلة، لكنها تتشارك حصة التزامن نفسها للمفتاح. ومع وجود مهام متوازية كثيرة قد يتعرض معدل طلباتك للتحديد؛ قلّل التزامن كما هو موضح أعلاه.

الخطوات التالية¶

• اطّلع على نصائح CLI لمزيد من الأوامر

• استكشف الأوامر المخصصة لإنشاء أوامر خاصة بفريقك

• راجع أفضل الممارسات لتحسين سير العمل بشكل أكبر

المؤسسات ←