Claude Code: تطبيق عملي: إضافة Chrome والمهام المتوازية

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

حان وقت القتال الفعلي. يوضح هذا الفصل قدرات Claude Code من خلال سيناريوهين عمليين — تطوير إضافة Chrome وإدارة المهام المتوازية.

💡 نصيحة: قيمة Claude Code في الممارسة ليست الإخراج الفردي، بل الحلقة المغلقة الكاملة "فهم المتطلبات → تفكيك المهام → تنفيذ → تحقق → تكرار".

📋 المتطلبات السابقة: الفصل 20 - نقاط التحقق والتراجع

1. ما ستتعلمه


2. التطبيق 1: تطوير إضافة Chrome

(1) نظرة عامة على المشروع

تحتاج أليس إضافة Chrome — "أداة تمييز التعليقات على صفحات الويب":

(2) دع Claude Code يتولى التطوير

TEXT 📖 للعرض فقط
> Create a Chrome extension: Webpage highlight annotation tool

Features:
1. Right-click menu "Highlight" after selecting text
2. Support 4 colors: yellow/green/blue/red
3. Persistent annotations (Chrome storage API)
4. Popup panel to manage annotation list
5. One-click export to Markdown

Tech: Manifest V3, TypeScript, no framework, native DOM

Claude Code:
  → Creating project structure (7 source files)
  → Creating manifest.json (Manifest V3)
  → Creating background.ts, content.ts, popup UI
  → Creating storage.ts, export.ts
  → Running: npm run build ✓
  Project created! Features complete.

▶ مثال 1: التحسين التكراري

TEXT 📖 للعرض فقط
# الجولة 1: الميزات الأساسية مكتملة، ابدأ التكرار

> Add feature: Click existing highlight to remove annotation
Claude Code: ✅ Added click-to-remove handler

> Add feature: Annotation list search support
Claude Code: ✅ Added search with filter

> Add feature: Support annotation in PDF pages
Claude Code: ✅ Added PDF.js integration

(3) بنية المشروع

TEXT 📖 للعرض فقط
chrome-highlighter/
├── manifest.json
├── src/
│   ├── background.ts
│   ├── content.ts
│   ├── popup/
│   ├── storage.ts
│   ├── export.ts
│   └── pdf-viewer.ts
├── dist/
├── package.json
└── tsconfig.json

3. التطبيق 2: إدارة المهام المتوازية

(1) السيناريو

يحتاج بوب لمعالجة 4 مهام مستقلة في وقت واحد:

  1. إضافة رفع صورة المستخدم
  2. تنفيذ واجهة برمجة تطبيقات تصدير البيانات
  3. إعادة هيكلة نظام التسجيل
  4. إضافة الاختبارات المفقودة

(2) تسلسلي أم متوازي

TEXT 📖 للعرض فقط
# تسلسلي: 8 + 6 + 10 + 5 = 29 دقيقة إجمالاً

# متوازي: max(8, 6, 10, 5) = 10 دقائق إجمالاً
# توفير 65% من الوقت

▶ مثال 2: تحذيرات المهام المتوازية

TEXT 📖 للعرض فقط
# المشكلة: التعديلات المتوازية لنفس الملف تسبب تعارضات

# الحل: كل مهمة تعدّل ملفات مختلفة
> Avatar only touches avatar.ts files
> Export only touches export.ts files
> Don't modify index.ts (I'll register routes manually)

Claude Code:
  Sub-agent 1 [avatar files] → ✅
  Sub-agent 2 [export files] → ✅
  Main agent: Generates route registration code for manual insertion

4. استراتيجية تفكيك المهام الكبيرة

(1) مبادئ التفكيك

المبدأ الوصف
الاستقلالية لا تبعيات ملفية بين المهام الفرعية
الذرية كل مهمة فرعية لها معايير إتمام واضحة
قابلية التحقق كل مهمة فرعية يمكن اختبارها بشكل مستقل
قابلية العكس كل مهمة فرعية يمكن التراجع عنها بشكل فردي

(2) خطوات التفكيك

TEXT 📖 للعرض فقط
المهمة الأصلية: "ترحيل المشروع من REST إلى GraphQL"

التفكيك:
1. تعريف GraphQL Schema (مستقل)
2. إنشاء User Resolver (مستقل، بعد Schema)
3. إنشاء Order Resolver (مستقل، بعد Schema)
4. إنشاء Payment Resolver (مستقل، بعد Schema)
5. إضافة DataLoader لتحسين N+1 (مستقل)
6. ترحيل طبقة المسارات (بعد جميع Resolvers)
7. حذف مسارات REST القديمة (الخطوة الأخيرة)

▶ مثال 3: التنفيذ المرحلي

TEXT 📖 للعرض فقط
# المرحلة 1: Schema → /checkpoint "schema-complete"
# المرحلة 2: Resolvers المتوازية → /checkpoint "resolvers-complete"
# المرحلة 3: ترحيل المسارات → /checkpoint "migration-complete"
# التحقق: جميع 134 اختباراً نجحت ✅

5. التحكم في التكلفة عملياً

TEXT 📖 للعرض فقط
المرحلة 1 (Schema):    $0.45
المرحلة 2 (Resolvers): $2.30 (4 وكلاء فرعيين)
المرحلة 3 (الترحيل): $1.80
الإجمالي:               $4.55

مقابل التطوير اليدوي: ~4 ساعات × $50/ساعة = $200+

❓ أسئلة شائعة

س هل يمكن لـ Claude Code بناء تطبيقات كاملة؟
ج نعم، مع التكرار. التوليد الأول عادة يحقق 80%؛ والـ 20% المتبقية تحتاج تكرارات متعددة.
س ما الحد الأقصى للمهام المتوازية؟
ج لا حد صارم، لكن يُنصح بـ 5-6. الزيادة تزيد احتمال التعارض واستهلاك Tokens.
س اعتبارات خاصة لإضافة Chrome؟
ج قيود Manifest V3، ومشاكل CSP لسكربتات المحتوى، والمراسلة غير المتزامنة. حدّد Manifest V3 في CLAUDE.md.
س ما أهم تقنية عملية؟
ج تفكيك المهام + نقاط التحقق. قسّم المهام الكبيرة إلى صغيرة، وتحقق عند كل نقطة، وتراجع بدقة عند الأخطاء.

📖 ملخص


📝 تمارين

  1. أساسي (⭐): أنشئ إضافة Chrome بسيطة (مثلاً: مؤقت الصفحة) باستخدام Claude Code.
  2. متوسط (⭐⭐): طوّر إضافة Chrome وأضف ميزتين تكرارياً باستخدام نقاط التحقق.
  3. متقدم (⭐⭐⭐): صمّم خطة 4 مهام متوازية، وقارن الوقت الفعلي واستهلاك Tokens مع التنفيذ التسلسلي.
Web-Tutorial.com

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

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

100%