المهارات cc-skill-coding-standards
📦

cc-skill-coding-standards

آمن

Faire respecter les normes de codage dans votre codebase

Une qualité de code incohérente entraîne des bugs et de la dette technique. Cette compétence fournit des normes de codage universelles, des meilleures pratiques et des modèles pour le développement TypeScript, JavaScript, React et Node.js pour vous aider à écrire du code propre et maintenable.

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

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

2

رفع في Claude

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

3

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

اختبرها

استخدام "cc-skill-coding-standards". Review this function for coding standards compliance: function get(u) { return fetch(u).then(d=>d.json()) }

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

Cette fonction enfreint plusieurs normes : nommage peu clair (get, u, d), aucune gestion d'erreur, aucune sécurité de typage, et retourne des données sans vérifier response.ok. La version refactorisée inclut : un nom descriptif (fetchMarketData), des types TypeScript appropriés, une gestion complète des erreurs avec try/catch, et une validation de la réponse.

استخدام "cc-skill-coding-standards". Generate a React button component following the standards

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

Composant fonctionnel avec interface TypeScript (ButtonProps), types de props appropriés (children, onClick, disabled, variant), valeurs par défaut pour les props optionnels, et structure HTML sémantique. Inclut la propagation de props et la composition de className.

استخدام "cc-skill-coding-standards". Check if this code follows immutability patterns: user.name = 'New Name'; items.push(newItem);

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

Ce code enfreint le principe d'immuabilité. La mutation directe d'objets et de tableaux provoque des effets secondaires inattendus. Approche correcte : utiliser l'opérateur spread pour les objets ({...user, name: 'New Name'}) et les tableaux ([...items, newItem]) pour créer de nouvelles références au lieu de muter celles existantes.

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

آمن
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
الملفات التي تم فحصها
528
الأسطر التي تم تحليلها
3
النتائج
1
إجمالي عمليات التدقيق
مشكلات منخفضة المخاطر (3)
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.
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.
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.
تم تدقيقه بواسطة: claude

درجة الجودة

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

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

Assistant de révision de code

Utilisez cette compétence pendant les révisions de code pour valider que les pull requests suivent les normes de codage établies et les meilleures pratiques.

Intégration des nouveaux développeurs

Aidez les nouveaux membres de l'équipe à comprendre les normes et conventions de votre codebase en fournissant des exemples et des modèles cohérents.

Amélioration de la qualité du code

Appliquez ces normes lors du refactoring de code legacy pour améliorer la maintenabilité et réduire la dette technique.

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

Réviser le code selon les normes
Review this code against the coding standards and best practices defined in the cc-skill-coding-standards skill. Identify any violations and suggest improvements.
Refactoriser selon les meilleures pratiques
Refactor this code to follow TypeScript and React best practices from the cc-skill-coding-standards skill. Focus on immutability, error handling, and component structure.
Générer du code conforme aux normes
Generate a [component/function/module] that follows the coding standards from cc-skill-coding-standards. Include proper types, error handling, and documentation.
Expliquer les violations de normes
Explain why this code violates the coding standards in cc-skill-coding-standards. Reference specific principles like KISS, DRY, or YAGNI.

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

  • Toujours utiliser des noms de variables et de fonctions descriptifs qui expliquent l'intention plutôt que des formes abrégées
  • Appliquer systématiquement des modèles d'immuabilité en utilisant les opérateurs spread au lieu de la mutation directe
  • Implémenter une gestion complète des erreurs pour les opérations asynchrones avec des blocs try/catch et une validation de réponse
  • Utiliser des types et interfaces TypeScript au lieu de 'any' pour maintenir la sécurité de typage

تجنب

  • Éviter la mutation directe d'objets et de tableaux - utiliser les opérateurs spread ou des modèles de mise à jour immuables
  • Ne pas utiliser le type 'any' en TypeScript - toujours définir des interfaces appropriées et des annotations de type
  • Ne jamais omettre la gestion d'erreurs dans les fonctions asynchrones - toujours inclure try/catch avec des messages d'erreur appropriés
  • Éviter les conditionnels profondément imbriqués - utiliser des retours anticipés et des clauses de garde pour la clarté

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

Ces normes de codage sont-elles obligatoires pour tous les projets ?
Non, ce sont des meilleures pratiques recommandées. Adaptez-les aux besoins spécifiques de votre équipe et aux conventions existantes. Les normes fournissent une base pour un code cohérent et de haute qualité.
Puis-je utiliser ces normes avec des langages autres que TypeScript et JavaScript ?
Bien que de nombreux principes comme KISS, DRY et YAGNI s'appliquent universellement, les exemples spécifiques ciblent les écosystèmes TypeScript et JavaScript. Adaptez les concepts à votre langage de choix.
Comment faire respecter ces normes dans mon équipe ?
Combinez ces normes avec des outils de linting (ESLint, Prettier), des hooks pre-commit et des checklists de révision de code. Utilisez la compétence pendant les révisions pour détecter les violations tôt.
Que faire si les normes entrent en conflit avec ma codebase existante ?
Appliquez les normes de manière incrémentale. Priorisez le nouveau code et les zones à haut risque lors du refactoring. L'adoption progressive est préférable à une tentative de réécriture complète.
Ces normes remplacent-elles le besoin de révisions de code ?
Non, ces normes complètent les révisions de code. Elles fournissent des critères objectifs d'évaluation, mais les révisions capturent également des décisions spécifiques au contexte et des considérations architecturales.
À quelle fréquence dois-je mettre à jour ces normes ?
Révisez et mettez à jour les normes trimestriellement ou lors de l'adoption de nouveaux frameworks. Équilibrez stabilité et évolution - résistez aux changements fréquents mais adaptez-vous aux nouvelles meilleures pratiques de l'écosystème.

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

بنية الملفات

📄 SKILL.md