Compétences cc-skill-coding-standards
📦

cc-skill-coding-standards

Sûr

فرض معايير الترميز عبر قاعدة الكود الخاصة بك

جودة الكود غير المتسقة تؤدي إلى أخطاء وديون تقنية. توفر هذه المهارة معايير ترميز عالمية وأفضل الممارسات وأنماطًا لتطوير TypeScript وJavaScript وReact وNode.js لمساعدتك على كتابة كود نظيف وقابل للصيانة.

Prend en charge: Claude Codex Code(CC)
🥉 72 Bronze
1

Télécharger le ZIP du skill

2

Importer dans Claude

Allez dans Paramètres → Capacités → Skills → Importer un skill

3

Activez et commencez à utiliser

Tester

Utilisation de "cc-skill-coding-standards". راجع هذه الدالة للامتثال لمعايير الترميز: function get(u) { return fetch(u).then(d=>d.json()) }

Résultat attendu:

هذه الدالة تنتهك معايير متعددة: تسمية غير واضحة (get، u، d)، لا يوجد تعامل مع الأخطاء، لا يوجد أمان للنوع، وتُرجع بيانات دون التحقق من response.ok. الإصدار المعاد هيكلته يتضمن: اسم وصفي (fetchMarketData)، أنواع TypeScript صحيحة، تعامل شامل مع الأخطاء مع كتل try/catch، والتحقق من صحة الاستجابة.

Utilisation de "cc-skill-coding-standards". ولد مكون زر React يتبع المعايير

Résultat attendu:

مكون وظيفي مع واجهة TypeScript (ButtonProps)، أنواع الخصائص الصحيحة (children، onClick، disabled، variant)، قيم افتراضية للخصائص الاختيارية، وهيكل HTML دلالي. يتضمن نشر الخصائص وتكوين className.

Utilisation de "cc-skill-coding-standards". تحقق مما إذا كان هذا الكود يتبع أنماط عدم القابلية للتغيير: user.name = 'New Name'; items.push(newItem);

Résultat attendu:

هذا الكود ينتهك مبدأ عدم القابلية للتغيير. التغيير المباشر للكائنات والمصفوفات يسبب آثارًا جانبية غير متوقعة. النهج الصحيح: استخدم عامل النشر للكائنات ({...user, name: 'New Name'}) والمصفوفات ([...items, newItem]) لإنشاء مراجع جديدة بدلاً من تغيير الموجود منها.

Audit de sécurité

Sûr
v1 • 2/25/2026

All 73 static analysis findings are false positives. The detected patterns (backtick execution, weak crypto, system reconnaissance) are Markdown code blocks and documentation examples, not executable code. This is a pure documentation skill with no executable functionality. No security risks identified.

1
Fichiers analysés
528
Lignes analysées
3
résultats
1
Total des audits
Problèmes à risque faible (3)
SKILL.md:44-54SKILL.md:58-68SKILL.md:72-84SKILL.md:88-95
Documentation Code Examples Trigger Static Scanner
The static scanner detected 53 instances of 'Ruby/shell backtick execution' patterns. These are Markdown code blocks (```typescript) used for documentation, not actual shell execution. The skill contains only code examples and best practices documentation.
SKILL.md:92SKILL.md:107
Fetch API Examples in Documentation
Detected 2 instances of fetch() calls at lines 92 and 107. These are documentation examples showing proper async/await error handling patterns, not actual network requests made by the skill.
SKILL.md:409
Dynamic Import for React Lazy Loading Example
Detected dynamic import() at line 409. This is a documentation example showing React's lazy() pattern for code splitting, not actual dynamic imports executed by the skill.
Audité par: claude

Score de qualité

38
Architecture
90
Maintenabilité
87
Contenu
50
Communauté
99
Sécurité
87
Conformité aux spécifications

Ce que vous pouvez construire

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

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

دمج المطورين الجدد

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

تحسين جودة الكود

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

Essayez ces prompts

مراجعة الكود مقابل المعايير 
راجع هذا الكود مقابل معايير الترميز وأفضل الممارسات المحددة في مهارة cc-skill-coding-standards. حدد أي انتهاكات واقترح تحسينات.
إعادة الهيكلة لأفضل الممارسات 
أعد هيكلة هذا الكود ليتبع أفضل ممارسات TypeScript وReact من مهارة cc-skill-coding-standards. ركز على عدم القابلية للتغيير والتعامل مع الأخطاء وهيكل المكونات.
توليد كود متوافق مع المعايير 
ولد [مكون/دالة/وحدة] يتبع معايير الترميز من cc-skill-coding-standards. تضمين الأنواع الصحيحة والتعامل مع الأخطاء والتوثيق.
شرح انتهاكات المعايير 
اشرح لماذا ينتهك هذا الكود معايير الترميز في cc-skill-coding-standards. ارجع إلى مبادئ محددة مثل KISS أو DRY أو YAGNI.

Bonnes pratiques

  • استخدم دائمًا أسماء متغيرات ودوال وصفية تشرح النية بدلاً من الأشكال المختصرة
  • طبق أنماط عدم القابلية للتغيير باستمرار باستخدام عوامل النشر بدلاً من التغيير المباشر
  • نفذ تعاملًا شاملاً مع الأخطاء للعمليات غير المتزامنة مع كتل try/catch والتحقق من صحة الاستجابة
  • استخدم أنواع TypeScript والواجهات بدلاً من 'any' للحفاظ على أمان النوع

Éviter

  • تجنب تغيير الكائنات والمصفوفات مباشرة - استخدم عوامل النشر أو أنماط التحديث غير القابلة للتغيير
  • لا تستخدم نوع 'any' في TypeScript - حدد دائمًا واجهات وتعليقات نوع صحيحة
  • لا تحذف أبدًا التعامل مع الأخطاء في الدوال غير المتزامنة - ضمّن دائمًا try/catch مع رسائل أخطاء صحيحة
  • تجنب الشروط المتداخلة بعمق - استخدم الإرجاعات المبكرة وبنود الحراسة للوضوح

Foire aux questions

هل معايير الترميز هذه إلزامية لجميع المشاريع؟
لا، هذه هي أفضل الممارسات الموصى بها. قم بتكييفها مع احتياجات فريقك المحددة واصطلاحاته الموجودة. توفر المعايير أساسًا للكود المتسق والعالي الجودة.
هل يمكنني استخدام هذه المعايير مع لغات أخرى غير TypeScript وJavaScript؟
بينما تنطبق العديد من المبادئ مثل KISS وDRY وYAGNI عالميًا، تستهدف الأمثلة المحددة أنظمة TypeScript وJavaScript. قم بتكييف المفاهيم مع لغتك المختارة.
كيف يمكنني فرض هذه المعايير في فريقي؟
اجمع هذه المعايير مع أدوات التدقيق (ESLint، Prettier) وخطافات ما قبل الالتزام وقوائم مرجعية لمراجعة الكود. استخدم المهارة أثناء المراجعات لاكتشاف الانتهاكات مبكرًا.
ماذا لو تعارضت المعايير مع قاعدة الكود الموجودة لدي؟
طبق المعايير بشكل تدريجي. أعطِ الأولوية للكود الجديد والمناطق عالية المخاطر عند إعادة الهيكلة. التبني التدريجي أفضل من محاولة إعادة كتابة كاملة.
هل تحل هذه المعايير محل الحاجة لمراجعات الكود؟
لا، هذه المعايير تكمل مراجعات الكود. توفر معايير موضوعية للتقييم، لكن المراجعات تلتقط أيضًا القرارات الخاصة بالسياق والاعتبارات المعمارية.
كم مرة يجب أن أحدث هذه المعايير؟
راجع وحدّث المعايير ربع سنويًا أو عند اعتماد أطر عمل جديدة.وازن بين الاستقرار والتطور - قاوم التغييرات المتكررة لكن تكيّف مع أفضل الممارسات الجديدة في النظام البيئي.

Détails du développeur

Auteur

affaan-m

Licence

MIT

Dépôt

https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/cc-skill-coding-standards

Réf

main

Structure de fichiers

📄 SKILL.md