المهارات clean-code
📦

clean-code

مراجعة المحتوى r2 آمن ⚙️ الأوامر الخارجية📁 الوصول إلى نظام الملفات

تحسين قابلية قراءة الكود باستخدام الكود النظيف

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

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

التثبيت باستخدام Agent لدي

انسخ هذا الطلب إلى Agent لديك. يتضمن صفحة Skill المعتمدة وملف manifest.

طلب الوكيل
Review the Skillstore skill "clean-code" from https://skillstore.io/skills/benny9193-clean-code.md and its manifest at https://skillstore.io/api/skills/benny9193-clean-code/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

يجب أن يواصل Agent عرض خطته وطلب أي تأكيد تفرضه سياسة الأمان.

موارد مهيّأة لـ Agents

استخدم هذه الروابط عندما يحتاج AI Agent أو crawler أو script إلى سياق نظيف بدلًا من قراءة الصفحة كاملة.

تفاصيل Markdown GET /skills/benny9193-clean-code.md manifest موقَّع GET /api/skills/benny9193-clean-code/manifest lockfile موقَّع GET /api/skills/benny9193-clean-code/lockfile

اختبرها

جارٍ استخدام "clean-code". تستخدم دالة أسماء قصيرة، ومعامل flag، وشروطا متداخلة.

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

  • أعد تسمية القيم بحيث يكون غرضها قابلا للبحث وواضحا.
  • قسّم السلوك المدفوع بـ flag إلى دوال منفصلة.
  • استخدم الإرجاع المبكر لتقليل التداخل وتحسين سهولة المسح البصري.

جارٍ استخدام "clean-code". تسأل مراجعة عما إذا كان ينبغي إبقاء التعليقات حول منطق أهلية معقد.

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

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

جارٍ استخدام "clean-code". يريد فريق قائمة تحقق لقابلية القراءة قبل pre-commit.

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

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

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

آمن
v9 • ٢٣‏/٧‏/٢٠٢٦ فتح التقرير المرتبط بالإصدار

All 34 static findings are false positives caused by Markdown fences, TypeScript template literals, and illustrative file-path examples. SKILL.md contains guidance only, with no executable scripts, command invocation, reconnaissance, prompt injection, or malicious intent. No remediation is required.

1
الملفات التي تم فحصها
256
الأسطر التي تم تحليلها
0
عناصر المراجعة
0
تم تجاهل الإيجابيات الكاذبة

عوامل الخطر

⚙️ الأوامر الخارجية (27)
SKILL.md:13-23 SKILL.md:23-26 SKILL.md:26-36 SKILL.md:36-39 SKILL.md:39-49 SKILL.md:49-54 SKILL.md:54-59 SKILL.md:59-73 SKILL.md:73-75 SKILL.md:75-78 SKILL.md:78-94 SKILL.md:94-97 SKILL.md:97-101 SKILL.md:101-113 SKILL.md:113-115 SKILL.md:115-118 SKILL.md:118-140 SKILL.md:140-145 SKILL.md:145-153 SKILL.md:153-156 SKILL.md:156-163 SKILL.md:163-168 SKILL.md:168-183 SKILL.md:183-186 SKILL.md:186-199 SKILL.md:199-209 SKILL.md:209-224
📁 الوصول إلى نظام الملفات (2)
SKILL.md:101 SKILL.md:113
لم يكتشف أحدث تدقيق ثابت ودلالي مكتمل أي نتائج أمنية مؤكدة. ولا يثبت ذلك أن المهارة خالية من الآثار الجانبية.
دقّقه: codex عرض سجل التدقيق →
شارك واستشهد بهذا التقرير

شارك تقرير التقييم المرتبط بالإصدار والشارة المحايدة وبطاقة التضمين والاستشهادات. تعرض Skillstore الأدلة من دون أن تقرر ما إذا كانت هذه المهارة آمنة.

فتح التقرير المرتبط بالإصدار
تقييم الأمان

نسخ رابط التقرير

https://skillstore.io/skills/benny9193-clean-code/audits/9?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

شارة Markdown

[![Skillstore security assessment](https://skillstore.io/badges/skills/benny9193-clean-code/security.svg)](https://skillstore.io/skills/benny9193-clean-code?utm_source=security_passport_badge)

شارة HTML

<a href="https://skillstore.io/skills/benny9193-clean-code?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/benny9193-clean-code/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

بطاقة قابلة للتضمين

<iframe src="https://skillstore.io/embed/skills/benny9193-clean-code.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>
الاستشهادات الأكاديمية (APA · BibTeX · CFF)

اقتباس APA

Benny9193. (2026). clean-code security audit report (audit version 9) [Author version unspecified]. Skillstore. https://skillstore.io/skills/benny9193-clean-code/audits/9

اقتباس BibTeX

@techreport{benny9193-benny9193-clean-code-2026, author = {Benny9193}, title = {clean-code security audit report (audit version 9)}, institution = {Skillstore}, year = {2026}, number = {9}, url = {https://skillstore.io/skills/benny9193-clean-code/audits/9}, note = {Author version unspecified} }

CITATION.cff

cff-version: 1.2.0 message: "If you use this Skill, cite its author and this versioned security audit report." title: "clean-code security audit report (audit version 9)" version: "unspecified" type: report authors: - name: "Benny9193" date-released: "2026-07-23" url: "https://skillstore.io/skills/benny9193-clean-code/audits/9" identifiers: - type: other value: "skillstore:benny9193-clean-code:audit:9" description: "Skillstore immutable audit report identifier"

مقارنة المتغيرات

3 متغيرات قابلة للتثبيت

تبقى مهارة كل مؤلف عنصراً مستقلاً قابلاً للتثبيت. يُرتب المتغير الموصى به وفق أدلة Skillstore.

سبب تصدر هذا المتغير

استخدام أعلى في Skillstore
sickn33 موصى به

sickn33-clean-code

تقييم Skillstore 79
موثوقية الأدلة مرتفع
استخدام Skillstore 20
تم التحديث

2026-09-09

DoubleslashSE

doubleslashse-clean-code

تقييم Skillstore 79
موثوقية الأدلة مرتفع
استخدام Skillstore 11
تم التحديث

2026-09-09

Benny9193 الحالي

benny9193-clean-code

تقييم Skillstore 78
موثوقية الأدلة مرتفع
استخدام Skillstore 14
تم التحديث

2026-09-09

تقييم Skillstore

سبب هذا التقييم موثوقية الأدلة: مرتفع
55
الهندسة المعمارية
85
قابلية الصيانة
87
المحتوى
71
المجتمع
83
الامتثال للمواصفات

ما الذي يمكنك بناؤه

مراجعة Pull Request

طبّق قائمة تحقق مشتركة للأسماء وحجم الدوال والتعليقات ومعالجة null والتنسيق قبل الدمج.

إعادة هيكلة الكود القديم

حدد تحسينات صغيرة في قابلية القراءة تقلل التداخل، وتوضح المسؤوليات، وتزيل الأسماء المربكة.

تعليم معايير الفريق

استخدم أمثلة موجزة لشرح عادات الكود النظيف أثناء التهيئة أو العمل الثنائي أو التدريب على المراجعة.

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

فحص أساسي للكود النظيف 
راجع هذا الكود بحثا عن مشكلات الكود النظيف. ركز على الأسماء، وغرض الدالة، والتعليقات، ومعالجة null، والتنسيق. أعِد أهم خمسة تغييرات.
خطة إعادة الهيكلة 
أنشئ خطة إعادة هيكلة لهذا الكود. افصل المسؤوليات، وقلل المعاملات، وحسن الأسماء، وأبق السلوك دون تغيير.
مراجعة Pull Request 
راجع هذا pull request باستخدام مبادئ الكود النظيف. جمّع الملاحظات حسب التأثير واشرح لماذا يحسن كل تغيير قابلية الصيانة.
تدقيق التوافق مع المعايير 
دقق هذا المكون من حيث التوافق مع الكود النظيف. أعط الأولوية للمخاطر، وحدد روائح الكود المتكررة، واقترح إصلاحات تدريجية مع اعتبارات الاختبار.

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

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

تجنب

  • لا تطلب عمليات إعادة كتابة واسعة دون تحديد الوحدة والقيود.
  • لا تعامل الأمثلة التوضيحية على أنها كود ملفات أو API جاهز للإنتاج.
  • لا تطبق كل قاعدة آليا عندما تتطلب وضوحية المجال استثناءات.

الأسئلة المتكررة

بماذا تساعد هذه المهارة؟
تساعد في مراجعة وتحسين قابلية قراءة الكود، والتسمية، وبنية الدوال، والتعليقات، ومعالجة الأخطاء، والتنسيق، وروائح الكود الشائعة.
هل يمكنها إعادة كتابة مشروعي بالكامل؟
لا. توفر إرشادات للمراجعة وإعادة الهيكلة المركزة، لكن عمليات إعادة الكتابة الواسعة تحتاج إلى سياق المشروع واختبارات.
هل هي مخصصة لـ TypeScript فقط؟
لا. تستخدم الأمثلة أسلوب TypeScript، لكن المبادئ تنطبق على العديد من لغات البرمجة.
هل تشغل أدوات التنسيق؟
لا. توصي بتنسيق متسق، لكنها لا تشغل Prettier أو Black أو أدوات تنسيق أخرى بنفسها.
هل يمكنها المساعدة في مراجعات الكود؟
نعم. يمكنها تحويل مبادئ الكود النظيف إلى تعليقات مراجعة مرتبة حسب الأولوية وخطوات مقترحة لإعادة الهيكلة.
هل تحل محل الاختبارات؟
لا. استخدم الاختبارات لتأكيد السلوك قبل اقتراحات إعادة الهيكلة وبعدها.

تفاصيل المطور

المؤلف

Benny9193

الترخيص

MIT

مراجعة Skillstore

r2

تنبيه الإصدار

لم يعلن المؤلف عن إصدار.

المستودع

https://github.com/Benny9193/devflow/tree/master/skills/clean-code

مرجع

8c3e20bba512c392d9b02ee748b18e0b09d4982c

حداثة الصيانة

٢٦‏/٧‏/٢٠٢٦

الاستخدام

12 تنزيلات · 239 مشاهدات

بنية الملفات

📄 SKILL.md

المزيد من Benny9193

عرض الكل

مهارات ذات صلة

عرض الكل
📦

code-context-finder

83

العثور على سياق الكود بشكل أسرع

بواسطة 89jobrien

غالبًا ما يضيع المطورون وقتًا في تتبع سبب وجود الكود وما الذي يعتمد عليه. توجه هذه المهارة Claude أو Codex أو Claude Code إلى جمع معرفة الرسم البياني ذات الصلة، والمستدعين، والاستيرادات، والاختبارات قبل إجراء التغييرات.

البرمجة والتطوير عرض