المهارات frontend-dev-guidelines
📦

frontend-dev-guidelines

آمن

Créez des applications React en production avec des patterns modernes

متاح أيضًا من: 0Chan-smc,0Chan-smc,BrianDai22,diet103,Dimon94,DojoCodingLabs,BOM-98

Les développeurs frontend rencontrent des difficultés avec des patterns incohérents et la dette technique dans les codebases React. Cette compétence fournit des standards opinonnés pour le data fetching Suspense-first, l'architecture basée sur les features, et la discipline TypeScript.

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

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

2

رفع في Claude

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

3

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

اختبرها

استخدام "frontend-dev-guidelines". Créer un composant de liste de produits avec Suspense

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

  • Composant ProductList créé avec le hook useSuspenseQuery
  • Encapsulé dans une boundary SuspenseLoader pour les états de chargement automatiques
  • Interface TypeScript définie pour le type de données Product
  • Layout MUI Grid avec sizing responsive utilisant la syntaxe v7
  • Configuration de requête cache-first pour des performances optimales

استخدام "frontend-dev-guidelines". Comment devrais-je organiser le code de la feature d'authentification

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

  • Créer la structure de directory features/authentication
  • Placer les appels API d'authentification dans api/authApi.ts avec des réponses typées
  • Implémenter le hook useAuth dans hooks/useAuth.ts
  • Exporter les interfaces publiques via les barrel exports index.ts
  • Garder les composants d'authentification dans le sous-directory components/

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

آمن
v1 • 2/25/2026

All 649 static analysis findings are false positives. The skill consists entirely of Markdown documentation files containing code examples for educational purposes. Patterns like external_commands, scripts, filesystem, and network references are illustrative code snippets teaching React TypeScript development, not executable code. No actual security risks detected.

11
الملفات التي تم فحصها
5,456
الأسطر التي تم تحليلها
0
النتائج
1
إجمالي عمليات التدقيق
لا توجد مشكلات أمنية
تم تدقيقه بواسطة: claude

درجة الجودة

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

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

Développement de Nouveaux Composants React

Générer des composants React prêts pour la production suivant les patterns Suspense-first avec des types TypeScript appropriés, du lazy loading, et du styling MUI

Standardisation de Codebase

Établir des patterns architecturaux cohérents entre les équipes avec une organisation basée sur les features, TypeScript strict, et une approche de styling unifiée

Modernisation de Code Legacy

Refactoriser des composants existants pour adopter useSuspenseQuery, supprimer les conditionnels isLoading, et implémenter des boundaries de lazy loading appropriées

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

Créer un Composant Suspense
Create a React component that displays user profile data. Use useSuspenseQuery for fetching, wrap with SuspenseLoader, and style with MUI sx prop. Include TypeScript types for the user data.
Configuration de Structure Basée sur les Features
Set up a feature-based folder structure for a dashboard application with features: analytics, user management, and settings. Show the api, components, hooks, helpers, and types subdirectories for each feature with index.ts exports.
Implémentation de Route Lazy Loadée
Implement a TanStack Router configuration for a dashboard route with lazy loading. Include a loader function that returns breadcrumb metadata and uses cache-first query strategy for initial data fetch.
Refactoring vers les Patterns Suspense
Refactor this legacy component that uses useQuery with isLoading checks to use useSuspenseQuery instead. Remove all early returns and conditional loading states. Show the before and after code with explanations.

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

  • Toujours utiliser useSuspenseQuery comme pattern de data fetching par défaut au lieu de useQuery avec des vérifications isLoading
  • Organiser le code par domaine de feature dans le directory features plutôt que par type technique
  • Lazyloder tout composant de route ou élément UI lourd comme les data grids et charts pour optimiser la taille du bundle

تجنب

  • Les patterns de early return pour les états de chargement comme if isLoading return null qui cassent les boundaries Suspense
  • Placer la logique métier spécifique aux features dans le directory générique components au lieu de features
  • Effectuer des appels API directs dans les composants au lieu d'utiliser des couches de service API feature centralisées

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

Pourquoi utiliser useSuspenseQuery au lieu de useQuery ?
useSuspenseQuery élimine les conditionnels isLoading en exploitant les boundaries React Suspense. Cela résulte en un code de composant plus propre avec une disponibilité de données garantie et une UX de chargement cohérente via des composants SuspenseLoader centralisés.
Quand devrais-je utiliser les styles inline versus des fichiers .styles.ts séparés ?
Utilisez les styles inline avec la prop sx pour les composants de moins de 100 lignes. Créez des fichiers séparés ComponentName.styles.ts pour les composants plus larges afin de maintenir la lisibilité et séparer les responsabilités.
Puis-je utiliser cette compétence avec des codebases React 17 existantes ?
Suspense pour le data fetching nécessite React 18 ou ultérieur. Pour les projets React 17, vous pouvez toujours appliquer l'organisation basée sur les features, les standards TypeScript, et les patterns de couche API tout en utilisant les patterns useQuery traditionnels.
Quelles dépendances sont requises pour suivre ces guidelines ?
Les dépendances principales incluent React 18+, TypeScript, TanStack Query v5, TanStack Router, et MUI v7. Optionnel mais recommandé : React Hook Form et Zod pour la gestion des formulaires.
Comment gérer les états d'erreur avec les patterns Suspense ?
Encapsulez les boundaries Suspense avec des composants ErrorBoundary provenant de react-error-boundary ou bibliothèques similaires. Utilisez le hook useMuiSnackbar pour des messages d'erreur conviviaux dans les composants qui déclenchent des mutations.
L'organisation basée sur les features est-elle adaptée aux petits projets ?
Pour les très petits projets de moins de 20 composants, une structure plus simple peut suffire. Cependant, l'organisation basée sur les features évolue de manière prévisible et établit de bonnes habitudes tôt. Commencez avec le pattern même pour les petits projets.