Claude Code: تطبيق عملي: إضافة Chrome والمهام المتوازية
آخر تحديث: 2026-08-31
حان وقت القتال الفعلي. يوضح هذا الفصل قدرات Claude Code من خلال سيناريوهين عمليين — تطوير إضافة Chrome وإدارة المهام المتوازية.
💡 نصيحة: قيمة Claude Code في الممارسة ليست الإخراج الفردي، بل الحلقة المغلقة الكاملة "فهم المتطلبات → تفكيك المهام → تنفيذ → تحقق → تكرار".
📋 المتطلبات السابقة: الفصل 20 - نقاط التحقق والتراجع
1. ما ستتعلمه
- التدفق الكامل لتطوير إضافة Chrome
- التطبيق العملي للمهام المتوازية
- استراتيجيات تفكيك المهام الكبيرة
- ممارسات التطوير التكراري
- التحكم في التكلفة عملياً
2. التطبيق 1: تطوير إضافة Chrome
(1) نظرة عامة على المشروع
تحتاج أليس إضافة Chrome — "أداة تمييز التعليقات على صفحات الويب":
- تمييز النص المحدد على أي صفحة ويب
- دعم تسميات ألوان متعددة
- تخزين مستمر للتعليقات التوضيحية
- تصدير التعليقات التوضيحية كـ Markdown
(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 مهام مستقلة في وقت واحد:
- إضافة رفع صورة المستخدم
- تنفيذ واجهة برمجة تطبيقات تصدير البيانات
- إعادة هيكلة نظام التسجيل
- إضافة الاختبارات المفقودة
(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.
س ما أهم تقنية عملية؟
ج تفكيك المهام + نقاط التحقق. قسّم المهام الكبيرة إلى صغيرة، وتحقق عند كل نقطة، وتراجع بدقة عند الأخطاء.
📖 ملخص
- إضافة Chrome: Claude Code يمكنه البدء من الصفر حتى الوظائف الكاملة
- المهام المتوازية: المهام الفرعية المستقلة تنفّذ بشكل متزامن، توفير 50-70% من الوقت
- التفكيك: الاستقلالية، الذرية، قابلية التحقق، قابلية العكس
- التنفيذ المرحلي + نقاط التحقق يضمنان أن كل خطوة قابلة للعكس
- التحكم في التكلفة: تعليمات دقيقة، تقسيم مراحل، Sonnet أولاً
📝 تمارين
- أساسي (⭐): أنشئ إضافة Chrome بسيطة (مثلاً: مؤقت الصفحة) باستخدام Claude Code.
- متوسط (⭐⭐): طوّر إضافة Chrome وأضف ميزتين تكرارياً باستخدام نقاط التحقق.
- متقدم (⭐⭐⭐): صمّم خطة 4 مهام متوازية، وقارن الوقت الفعلي واستهلاك Tokens مع التنفيذ التسلسلي.