المهارات code-documentation-code-explain
📦

code-documentation-code-explain

آمن

شرح الكود المعقد باستخدام مخططات بصرية

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

يدعم: Claude Codex Code(CC)
🥉 73 برونزي
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "code-documentation-code-explain". اشرح نمط المُزيّن هذا مع مخطط بصري

النتيجة المتوقعة:

ملخص عالي المستوى لغرض المُزيّن، ومخطط فئات Mermaid يوضح علاقة الغلاف، وتدفق التنفيذ خطوة بخطوة، وتشبيه من العالم الحقيقي، وأمثلة كود مع مقارنة قبل/بعد

استخدام "code-documentation-code-explain". استعرض هذه الدالة التعاودية بصريًا

النتيجة المتوقعة:

تصور مكدس الاستدعاءات مع مخطط شجري يوضح كل استدعاء تعاودي، وشرح الحالة الأساسية، ورسم متحرك لانتشار قيمة الإرجاع، وتحليل التعقيد مع تدوين Big-O

التدقيق الأمني

آمن
v1 • 2/25/2026

Static analysis flagged 71 patterns in markdown documentation containing educational Python code examples. All findings are false positives - the detected patterns (shell commands, URLs, crypto references) exist only in code samples for teaching purposes, not in executable skill logic. The skill is a documentation and code explanation tool with no actual command execution, network access, or filesystem operations.

2
الملفات التي تم فحصها
852
الأسطر التي تم تحليلها
4
النتائج
1
إجمالي عمليات التدقيق
مشكلات متوسطة المخاطر (1)
resources/implementation-playbook.md:12-789SKILL.md:37-48
Static Analysis False Positive - External Commands
Static scanner detected 'Ruby/shell backtick execution' patterns in markdown code blocks. These are fenced code blocks (```python, ```mermaid) in documentation, not actual shell execution. The skill contains only educational examples.
مشكلات منخفضة المخاطر (3)
resources/implementation-playbook.md:750
Static Analysis False Positive - Network URL
Hardcoded URL detected at line 750 is a learning resource link (https://realpython.com/async-io-python/) in educational content, not actual network code executed by the skill.
resources/implementation-playbook.md:46-757SKILL.md:3-26
Static Analysis False Positive - Cryptographic Algorithm
Weak cryptographic algorithm patterns detected in educational code examples within markdown documentation. These are teaching examples, not executable code used by the skill.
resources/implementation-playbook.md:107-797
Static Analysis False Positive - System Reconnaissance
System reconnaissance patterns detected in educational Python code samples. These are demonstration examples for teaching code analysis concepts, not actual reconnaissance functionality.
تم تدقيقه بواسطة: claude

درجة الجودة

38
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
50
المجتمع
94
الأمان
91
الامتثال للمواصفات

ماذا يمكنك بناءه

انضمام المطورين

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

تعلم الخوارزميات المعقدة

تفصيل خوارزميات الترتيب والتعاود وهياكل البيانات مع تصورات خطوة بخطوة توضح كل حالة تنفيذ.

توثيق مراجعة الكود

إنشاء شروحات واضحة لطلبات السحب المعقدة، مع إبراز أنماط التصميم المستخدمة والمخاطر المحتملة وتوصيات أفضل الممارسات.

جرّب هذه الموجهات

شرح الكود الأساسي 
اشرح قسم الكود هذا: [paste code]. ضمّن ملخصًا عالي المستوى وحدد مفاهيم البرمجة الرئيسية المستخدمة.
إنشاء مخطط انسيابي 
حلل هذه الدالة وأنشئ مخطط Mermaid انسيابي يوضح تدفق التنفيذ ونقاط القرار واستدعاءات الدوال: [paste code]
تصور الخوارزمية 
تحليل نمط التصميم 
 
حدد أنماط التصميم في قاعدة الكود هذه واشرح كل منها بمخطط فئات وفوائد وسلبيات وطرق بديلة: [paste code]
 
 
أفضل الممارسات
 
  •  ابدأ بنظرة عامة عالية المستوى قبل الغوص في تفاصيل التنفيذ
  •  استخدم المخططات البصرية alongside شروحات النص لفهم أفضل
  •  وفر تعقيدًا تقدميًا - شرح للمبتدئين أولاً، ثم تفاصيل متقدمة
 
 
تجنب
 
  •  شرح الكود سطرًا بسطر دون إنشاء الغرض العام أولاً
  •  استخدام المصطلحات التقنية دون تعريفها لمستوى الجمهور المستهدف
  •  توفير شروحات نصية فقط عندما توضح المخططات البصرية التدفق
 
 
الأسئلة المتكررة
 
ما لغات البرمجة التي تدعمها هذه المهارة؟  
تعمل المهارة بشكل أفضل مع Python وJavaScript بسبب مكتبات الأنماط الواسعة، ولكن يمكنها شرح الكود في معظم اللغات الرئيسية بما في ذلك Java وGo وRust وTypeScript.
هل يمكن لهذه المهارة إنشاء مخططات لأي كود؟  
يتم إنشاء المخططات بصيغة Mermaid التي تعرض في معظم عارضات markdown. المخططات الانسيابية ومخططات الفئات ومخططات التسلسل مدعومة. المنطق المتداخل المعقد قد يتطلب تمثيلات مبسطة.
هل تنفذ أو تختبر هذه المهارة الكود الذي تحلله؟  
لا، هذه المهارة تحلل وتشرح الكود بشكل ثابت فقط. لا تنفذ أو تشغل أو تختبر الكود. جميع الشروحات مبنية على التحليل الثابت لهيكل الكود.
ما مدى تفصيل الشروحات خطوة بخطوة؟  
الشروحات تقدمية - تبدأ بنظرة عامة بسيطة، ثم تغوص في المكونات الرئيسية. يمكنك طلب المزيد من التفاصيل حول أقسام محددة أو طلب شروحات بمستوى مبتدئ/متقدم.
هل يمكن لهذه المهارة المساعدة في فهم التصحيح؟  
نعم، يمكن للمهارة شرح سبب حدوث الأخطاء عن طريق تتبع تدفق التنفيذ وتحديد حالات الحافة وإبراز المخاطر الشائعة في هيكل الكود.
هل هذه المهارة مناسبة لمبتدئي البرمجة بالكامل؟  
نعم، تتضمن الشروحات تشبيهات بسيطة وتبني التعقيد تدريجيًا. حدد مستوى خبرتك للحصول على شروحات مناسبة ومستهدفة.
 
 
تفاصيل المطور
 
المؤلف
 sickn33
 
الترخيص
 
MIT
 
المستودع
 https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/code-documentation-code-explain
 
مرجع
 
main
 
بنية الملفات
 
📁 resources/
 
📄 implementation-playbook.md
 
📄 SKILL.md