هندسة Claude Code المركبة

تمدد إضافة الهندسة المركبة Claude Code بوكلاء متخصصين وأوامر slash ومهارات وسير عمل منظم لدورات التخطيط ← العمل ← المراجعة ← التركيب.

التثبيت

الخطوة	الأمر
تثبيت Claude Code	اتبع إعداد claude.ai/code
استنساخ الإضافة	git clone https://github.com/anthropics/claude-code-plugins
إضافتها إلى Claude Code	أضف مسار الإضافة في إعدادات Claude Code
التحقق	شغّل /help في Claude Code لرؤية الأوامر المتاحة

دورة سير العمل الأساسية

المرحلة	أمر Slash	الوصف
التخطيط	/plan	تحويل أوصاف الميزات إلى خطط تنفيذ منظمة
العمل	/lfg	هندسة مستقلة كاملة — تنفيذ الخطط بتنسيق متعدد الوكلاء
المراجعة	/review-pr	مراجعة شاملة لطلبات السحب باستخدام وكلاء متوازيين متخصصين
التركيب	/compound	توثيق المشاكل المحلولة لبناء المعرفة المؤسسية

أوامر Slash

التخطيط والبنية

الأمر	الوصف
/plan	إنشاء خطط تنفيذ منظمة بتفاصيل على مستوى الملفات
/brainstorm	استكشاف المتطلبات والمناهج قبل التخطيط
/deepen-plan	تعزيز الخطة بوكلاء بحث متوازيين للعمق وأفضل الممارسات
/plan_review	مراجعة الخطة من قبل وكلاء متخصصين متعددين بالتوازي

التطوير والتنفيذ

الأمر	الوصف
/lfg	سير عمل هندسي مستقل كامل — تخطيط وتنفيذ واختبار ومراجعة
/resolve_parallel	حل جميع تعليقات TODO باستخدام المعالجة المتوازية
/resolve_pr_parallel	حل جميع تعليقات طلبات السحب باستخدام المعالجة المتوازية
/resolve_todo_parallel	حل جميع مهام CLI المعلقة باستخدام المعالجة المتوازية

المراجعة والجودة

الأمر	الوصف
/review-pr	مراجعة شاملة لطلبات السحب بوكلاء متخصصين (كود وأمان وأداء)
/code-review	مراجعة تغيير كود محدد مقابل الخطة والمعايير
/test-browser	تشغيل اختبارات المتصفح على الصفحات المتأثرة بطلب السحب أو الفرع الحالي
/reproduce-bug	إعادة إنتاج الأخطاء والتحقيق فيها باستخدام السجلات ووحدة التحكم ولقطات الشاشة

التوثيق والمعرفة

الأمر	الوصف
/compound	توثيق مشكلة محلولة للمعرفة المؤسسية
/changelog	إنشاء سجلات تغيير جذابة للدمج الأخير في الفرع الرئيسي
/deploy-docs	التحقق من صحة التوثيق وإعداده لنشر GitHub Pages
/release-docs	بناء وتحديث موقع التوثيق بالمكونات الحالية

أدوات مساعدة

الأمر	الوصف
/generate_command	إنشاء أمر slash مخصص جديد
/triage	فرز النتائج وتصنيفها لنظام مهام CLI
/feature-video	تسجيل فيديو عرض للميزة وإضافته لوصف طلب السحب
/agent-native-audit	تشغيل مراجعة شاملة لبنية أصلية للوكيل

الوكلاء المتخصصون

وكلاء مراجعة الكود

الوكيل	الغرض
code-reviewer	مراجعة الأخطاء والأخطاء المنطقية والأمان وجودة الكود
code-simplifier	تبسيط الكود للوضوح مع الحفاظ على الوظائف
silent-failure-hunter	تحديد الفشل الصامت والتعامل غير الكافي مع الأخطاء
comment-analyzer	تحليل التعليقات للدقة وقابلية الصيانة
pr-test-analyzer	مراجعة جودة تغطية الاختبارات واكتمالها
type-design-analyzer	تحليل خبير لتصميم الأنواع والثوابت
code-simplicity-reviewer	مرور نهائي للامتثال لمبدأ YAGNI والحد الأدنى من التعقيد

وكلاء البنية والأمان

الوكيل	الغرض
architecture-strategist	تقييم قرارات تصميم النظام وحدود المكونات
security-sentinel	تدقيقات أمنية وتقييم الثغرات والامتثال لـ OWASP
performance-oracle	تحليل الأداء والخوارزميات والاختناقات وقابلية التوسع
agent-native-reviewer	ضمان إمكانية وصول الوكلاء للميزات وليس البشر فقط
pattern-recognition-specialist	كشف أنماط التصميم ومضادات الأنماط وتكرار الكود

مراجعون خاصون باللغة

الوكيل	الغرض
kieran-rails-reviewer	مراجعة صارمة لاتفاقيات Rails والجودة
kieran-python-reviewer	مراجعة صارمة لاتفاقيات Python والجودة
kieran-typescript-reviewer	مراجعة صارمة لاتفاقيات TypeScript والجودة
dhh-rails-reviewer	مراجعة Rails من منظور DHH — كشف مضادات الأنماط
julik-frontend-races-reviewer	كشف حالات السباق في الواجهة الأمامية في JS/Stimulus

وكلاء البيانات والنشر

الوكيل	الغرض
data-integrity-guardian	هجرات قواعد البيانات وقيود البيانات والتكامل المرجعي
data-migration-expert	التحقق من تعيينات المعرفات وسلامة التراجع وتحويلات البيانات
deployment-verification-agent	قوائم فحص ما قبل/بعد النشر والتحقق بـ SQL وخطط التراجع

وكلاء البحث

الوكيل	الغرض
framework-docs-researcher	جلب توثيق شامل لأطر العمل وأفضل الممارسات
learnings-researcher	البحث في الدروس المؤسسية في docs/solutions/
best-practices-researcher	جمع أفضل الممارسات الخارجية من التوثيق والمصادر المفتوحة
git-history-analyzer	تحليل أثري لتاريخ git وتطور الكود
repo-research-analyst	تحليل شامل لبنية المستودع والأنماط

وكلاء التصميم

الوكيل	الغرض
figma-design-sync	مزامنة التنفيذ مع تصاميم Figma
design-implementation-reviewer	التحقق من مطابقة واجهة المستخدم لمواصفات Figma
design-iterator	تحسين التصميم التكراري من خلال N دورات من لقطة الشاشة-التحليل-الإصلاح

المهارات

مهارات التطوير

المهارة	المحفز
frontend-design	بناء مكونات ويب بجودة تصميم عالية
agent-native-architecture	تصميم تطبيقات حيث الوكلاء مواطنون من الدرجة الأولى
dspy-ruby	إطار عمل Ruby لتطبيقات LLM آمنة النوع وقابلة للتركيب
andrew-kane-gem-writer	كتابة جواهر Ruby وفق أنماط Andrew Kane
dhh-rails-style	كتابة كود Ruby/Rails بأسلوب DHH و37signals

مهارات سير العمل

المهارة	المحفز
brainstorming	استكشاف النية والمناهج قبل التنفيذ
git-worktree	إدارة أشجار عمل Git للتطوير المتوازي المعزول
file-todos	إدارة نظام تتبع المهام القائم على الملفات
every-style-editor	مراجعة وتحرير النص وفق دليل أسلوب Every
compound-docs	التقاط المشاكل المحلولة كتوثيق مصنف

مهارات تكامل الأدوات

المهارة	المحفز
agent-browser	أتمتة المتصفح باستخدام CLI الخاص بـ agent-browser من Vercel
rclone	رفع ومزامنة الملفات عبر مزودي التخزين السحابي
gemini-imagegen	إنشاء وتحرير الصور باستخدام واجهة Gemini API
xcode-test	بناء واختبار تطبيقات iOS على المحاكي
skill-creator	دليل لإنشاء مهارات جديدة فعالة

الخطافات

الخطاف	الحدث	الغرض
SessionStart	تهيئة الجلسة	إعداد السياق وتحميل الذكريات
PreToolUse	قبل تنفيذ الأداة	التحقق وحظر الأوامر الخطرة
PostToolUse	بعد تنفيذ الأداة	معالجة النتائج وتشغيل المتابعات
Stop	اكتمال الوكيل	الفحوصات النهائية والتنظيف
UserPromptSubmit	إرسال المستخدم رسالة	المعالجة المسبقة لمدخلات المستخدم

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

يطلق أمر /review-pr عدة وكلاء متخصصين بالتوازي:

┌─────────────────────────────────────────────────┐
│                  /review-pr                      │
├─────────────────────────────────────────────────┤
│  ┌──────────┐  ┌──────────┐  ┌──────────┐      │
│  │ Code     │  │ Security │  │ Perf     │      │
│  │ Reviewer │  │ Sentinel │  │ Oracle   │      │
│  └────┬─────┘  └────┬─────┘  └────┬─────┘      │
│       │              │              │            │
│  ┌────┴─────┐  ┌────┴─────┐  ┌────┴─────┐      │
│  │ Silent   │  │ Type     │  │ Pattern  │      │
│  │ Failure  │  │ Design   │  │ Recog.   │      │
│  └────┬─────┘  └────┬─────┘  └────┴─────┘      │
│       └──────────┬───┘──────────────┘            │
│            Consolidated Report                   │
└─────────────────────────────────────────────────┘

حالات الاستخدام الشائعة

تطوير الميزات

# 1. العصف الذهني للنهج
/brainstorm

# 2. إنشاء خطة منظمة
/plan

# 3. التعميق بوكلاء البحث
/deepen-plan

# 4. التنفيذ المستقل
/lfg

# 5. مراجعة طلب السحب
/review-pr

# 6. توثيق ما تعلمته
/compound

حل تعليقات طلبات السحب

# حل جميع تعليقات طلب السحب بالتوازي
/resolve_pr_parallel

# أو حل جميع TODO عبر قاعدة الكود
/resolve_parallel

إنشاء أوامر مخصصة

# إنشاء أمر slash جديد
/generate_command

# إنشاء مهارة جديدة
استخدم مهارة skill-creator للإرشاد

التكوين

بنية الإضافة

compound-engineering/
├── plugin.json          # بيان الإضافة
├── commands/            # تعريفات أوامر slash
│   ├── lfg.md
│   ├── plan.md
│   ├── review-pr.md
│   └── ...
├── agents/              # تعريفات الوكلاء
│   ├── code-reviewer.md
│   ├── security-sentinel.md
│   └── ...
├── skills/              # تعريفات المهارات
│   ├── frontend-design/
│   ├── agent-native-architecture/
│   └── ...
└── hooks/               # خطافات الأحداث
    ├── session-start.md
    └── ...

تكوين الوكيل

يتم تعريف الوكلاء في ملفات Markdown مع بيانات YAML الوصفية:

---
name: "code-reviewer"
description: "Reviews code for bugs, logic errors, and quality"
tools:
  - Glob
  - Grep
  - Read
  - Task
model: sonnet  # or opus, haiku
---

أفضل الممارسات

• ابدأ بـ /brainstorm قبل القفز إلى التنفيذ — فهو يكشف الحالات الحدية مبكراً
• استخدم /plan لأي شيء غير بسيط — حتى الميزات “البسيطة” تستفيد من التفكير المنظم
• شغّل /review-pr قبل الدمج — المراجعة متعددة الوكلاء تكتشف مشاكل تفوتها المراجعة الواحدة
• وثّق مع /compound — المعرفة المؤسسية تمنع تكرار الأخطاء
• استخدم /deepen-plan للميزات المعقدة — وكلاء البحث يضيفون عمقاً من التوثيق وأفضل الممارسات
• استفد من الحل المتوازي — /resolve_parallel يعالج TODO أسرع من الإصلاحات المتسلسلة
• أنشئ مهارات مخصصة للأنماط المتكررة — غلّف معرفة المجال لإعادة الاستخدام
• استخدم نموذج haiku للوكلاء السريعين — تقليل التكلفة ووقت الاستجابة للمهام المباشرة

استكشاف الأخطاء وإصلاحها

المشكلة	الحل
الوكيل غير موجود	تحقق من مسار الإضافة في إعدادات Claude Code وأعد التشغيل
الأمر غير معروف	شغّل /help لعرض الأوامر المتاحة، تحقق من plugin.json
الوكيل يعيد نتيجة فارغة	تحقق من توفر النموذج، قد تحتاج مفتاح API لـ opus/sonnet
مراجعة متعددة الوكلاء بطيئة	استخدم نموذج haiku للوكلاء السريعين وsonnet للحرجين
المهارة لا تنطلق	تحقق من أن وصف المهارة يطابق صياغة طلبك
الخطاف لا يعمل	تحقق من تطابق نوع حدث الخطاف (PreToolUse مقابل PostToolUse)
الخطة غامضة جداً	استخدم /deepen-plan مع وكلاء البحث لمزيد من التفاصيل
المراجعة تفتقد السياق	قدم عنوان URL لطلب السحب أو اسم الفرع صراحةً لـ /review-pr