/explain · شرح المشاريع بالعربية والإنجليزية

جرّب العرض التجريبي · English below ↓

مهارة (Skill) لـ Claude تشرح أي مشروع برمجي شرحًا كاملًا بالعربية أو بالإنجليزية، في صفحة تفاعلية واحدة. الصفحة العربية من اليمين إلى اليسار، والإنجليزية من اليسار إلى اليمين. المطور المبتدئ يفهم منها المشروع، والمطور الخبير يستخدمها خريطةً بجانب الكود.

افتح أي مشروع في Claude Code واكتب:

/explain

استلمت مشروعًا لا تعرف من أين تبدأ فيه؟ أو كتبته مع الذكاء الاصطناعي ولا تفهم كيف يعمل؟ يقرأ Claude الكود الحقيقي، ثم يكتب لك صفحة تشرح ما هو المشروع، ومم يتكوّن، وكيف يتحرك الطلب داخله، وأين تغيّر ما تريد. كل مسار ورقم سطر في الصفحة يُفحص على المشروع قبل أن تصلك.

المحتويات

• البدء السريع
• ثلاثة أعماق للشرح
• بالعربية أو بالإنجليزية
• ماذا تجد في الصفحة
• أمثلة على الطلبات
• العرض التجريبي
• جرّبها بدون مشروع
• كيف تعمل
• التكلفة
• الخصوصية

البدء السريع

1. ثبّت المهارة. لكل مشاريعك:

git clone https://github.com/AmrSabbagh35/project-explainer.git ~/.claude/skills/explain

أو لمشروع واحد فقط، حتى يستخدمها كل الفريق:

git clone https://github.com/AmrSabbagh35/project-explainer.git .claude/skills/explain

2. أعد تشغيل Claude Code، ثم افتح المشروع الذي تريد فهمه.

3. اكتب /explain. بعد دقائق تصلك صفحة الشرح: رابطًا إذا كانت أداة Artifacts متاحة، أو ملف HTML تفتحه في المتصفح.

تحتاج فقط Python 3، بدون أي مكتبات إضافية، ولا أي اشتراك أو خدمة صور مدفوعة. كل الأشكال يرسمها Claude بنفسه بصيغة SVG.

ثلاثة أعماق للشرح

الأمر	متى تستخدمه	ماذا تحتوي الصفحة
/explain سريع	تريد أن تعرف ما هذا المشروع في 5 دقائق	فكرة المشروع، وطبقاته وأهم 5–12 جزءًا فيه، ورحلة واحدة قصيرة، و«أين أغيّر ماذا؟».
/explain أو /explain كامل	تتعلّم المشروع أو تستلمه	كل ما سبق، مع التشبيه وفريقه، و12–22 جزءًا، وقاعدة البيانات، وقصة المشروع من git، والقاموس، و3 تمارين، وشجرة الملفات.
/explain عميق	ستعدّل الكود أو تراجعه	كل ما سبق، مع رحلتين أو ثلاث في تبويبات، وما بداخل كل جزء مهم (الدوال وأرقام أسطرها)، و«ملاحظات المراجعة»، و4–5 تمارين.

كلمات أخرى تعمل أيضًا: «مختصر» و«نظرة سريعة» للسريع، و«مفصل» و«تفصيلي» و«للمراجعة» للعميق. ويمكنك كتابتها بالإنجليزية: quick و full و deep. يظهر عمق الشرح في رأس الصفحة بثلاثة أعمدة صغيرة، وتنتهي الصفحة السريعة والكاملة بسطر يدلّك على العمق التالي.

بالعربية أو بالإنجليزية

تُكتب الصفحة بلغة طلبك: «اشرح لي المشروع» تعطيك صفحة عربية، و "explain this repo" تعطيك صفحة إنجليزية. ويمكنك أن تختار اللغة صراحة:

الأمر	اللغة
/explain بالعربية أو /explain ar	العربية، من اليمين إلى اليسار، وحروف الأجزاء من أبجد.
/explain en أو /explain in English	الإنجليزية، من اليسار إلى اليمين، وحروف الأجزاء من A إلى Z.

اللغة والعمق مستقلان، فيمكنك الجمع بينهما: /explain en quick أو /explain عميق بالعربية. القالب واحد في اللغتين، فتبقى كل الأقسام والتفاعل كما هي.

ماذا تجد في الصفحة

الصور التالية من صفحة عميقة لمشروع مثال خيالي (تطبيق «مكتبتي» لاستعارة الكتب)، موجود في مجلد examples/.

خريطة الطبقات

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

رحلة الطلب خطوة بخطوة

اتبع عملًا واحدًا، مثل «احجز كتابًا»، من الضغطة حتى الحفظ. كل محطة تحمل حرف الجزء الذي يعمل فيها، وزر «شغّل الرحلة» يمرّ عليها وحده. في الشرح العميق تجد رحلتين أو ثلاثًا في تبويبات.

تشبيه من عالم المشروع نفسه

مستشفى لتطبيق طبي، وحكم ولوحة نتائج لتطبيق رياضي، وأمين مكتبة لتطبيق مكتبة. كل دور في التشبيه مربوط بالكلاس الذي يؤديه في الكود.

ملاحظات المراجعة (في الشرح العميق)

ما لاحظه Claude أثناء القراءة: أشياء ناقصة، ومخاطر، ومشاكل أمان، وديون تقنية، وبطء. كل ملاحظة تشير إلى ملفها وسطرها، ولا تُكتب إلا إذا كان الكود يثبتها.

وأيضًا

• خريطة قاعدة البيانات: الجداول وأعمدتها، والعلاقات بجمل عربية بسيطة مثل «كل استعارة تخص قارئًا واحدًا».
• قصة المشروع من git log: اللحظات التي تشرح لماذا الكود مكتوب بهذه الطريقة اليوم.
• الشاشات أو المسارات أو الأوامر، حسب نوع المشروع.
• قاموس للكلمات التي ستراها في الكود، وجدول «أين أغيّر ماذا؟».
• تمارين بأرقام أسطر حقيقية، مع الإجابات.
• أشكال توضيحية يرسمها Claude عند الحاجة: أين يعمل كل جزء، أو مسار أمان، أو حالات الطلب.
• مفتاح مبتدئ / خبير: وضع المبتدئ يخفي المسارات والتفاصيل التقنية ويبقي الشرح.
• تعمل بالوضع الفاتح والداكن وعلى الهاتف، وتتذكر آخر جزء اخترته.

أمثلة على الطلبات

ما تكتبه	ما يحدث
/explain	شرح كامل للمشروع المفتوح.
/explain سريع	نظرة سريعة على المشروع المفتوح.
/explain ~/Projects/shop	شرح كامل لمشروع آخر.
/explain عميق ~/Projects/shop	شرح عميق مع ملاحظات المراجعة.
/explain مسار الدفع	شرح كامل تركّز رحلته على الدفع.
«استلمت هذا المشروع ولا أفهم كيف يعمل، ارسم لي مكوناته»	تعمل المهارة تلقائيًا، بدون /explain.
«أريد شرحًا مختصرًا للمشروع للطلاب الجدد»	شرح سريع.
«Explain this repo in Arabic for my team»	شرح كامل بالعربية.
/explain en أو «Help me understand this repo»	شرح كامل بالإنجليزية.

العرض التجريبي

افتح صفحات المشروع الخيالي مباشرة في المتصفح، بدون تثبيت شيء: صفحة سريعة، وصفحة كاملة، وصفحة عميقة. وبالإنجليزية: quick، وfull، وdeep. جرّب الضغط على الأجزاء، وتشغيل الرحلة، ومفتاح مبتدئ / خبير.

جرّبها بدون مشروع

في مجلد examples/ ملفات بيانات لنفس المشروع الخيالي، لكل عمق وبكل لغة (الإنجليزية تنتهي بـ -en). ابنِ أي منها وافتحه:

This is the beginning of the README. Read the rest at the original. Read the full README ↗