Que fait générateur-de-plan-de-structure-de-dossiers ?
Invite exhaustive et indépendante de la technologie pour analyser et documenter les structures de dossiers de projets. Détecte automatiquement les types de projets (.NET, Java, React, Angular, Python, Node.js, Flutter), génère des plans détaillés avec options de visualisation, conventions de nommage, modèles de placement de fichiers et gabarits d'extension pour maintenir une organisation cohérente du code sur diverses piles technologiques.
Résumé
Ce plan de structure fournit une approche standardisée pour analyser et documenter l'organisation des dossiers de n'importe quel projet logiciel. Il aide les équipes à maintenir la cohérence, facilite l'intégration des nouveaux développeurs et garantit que les pratiques architecturales sont respectées sur l'ensemble des projets.
Fonctionnalités
- Détection de type de projet : Identifie automatiquement le framework ou le langage du projet
- Options de visualisation : Génère soit une arborescence texte, soit un diagramme visuel de la structure
- Conventions de nommage : Documente les conventions utilisées pour les fichiers, dossiers et composants
- Modèles de placement : Explique où placer les différents types de fichiers (composants, utilitaires, tests, etc.)
- Gabarits d'extension : Fournit des modèles pour ajouter de nouvelles fonctionnalités conformément à la structure existante
Utilisation
Invite de base :
Analysez la structure du projet dans [chemin/vers/projet] et générez un plan de structure de dossiers incluant la détection du type de projet, une visualisation de l'arborescence, les conventions de nommage et les modèles de placement.
Options avancées :
--format : json|tree|diagram- Choisir le format de sortie--export : fichier.md- Exporter le plan vers un fichier--validate- Valider la structure actuelle par rapport aux meilleures pratiques--template : mon-gabarit- Utiliser un gabarit personnalisé pour la documentation
Exemple de sortie
Type de projet : React
Framework : React 18 + TypeScript + Vite
Structure :
src/
├── components/ # Composants réutilisables
│ ├── ui/ # Composants d'interface utilisateur
│ └── features/ # Composants spécifiques aux fonctionnalités
├── hooks/ # Hooks React personnalisés
├── pages/ # Composants de page/route
├── services/ # Logique métier et appels API
├── styles/ # Feuilles de style globales
└── utils/ # Fonctions utilitaires
Conventions de nommage :
- Composants : PascalCase (ex : UserProfile.tsx)
- Hooks : camelCase préfixé par 'use' (ex : useAuth.ts)
- Fichiers de test : *.test.tsx ou *.spec.ts
- Fichiers de style : *.module.css ou *.styled.ts
Placement des fichiers :
- Pages : src/pages/<nom-de-la-page>/
- Composants partagés : src/components/ui/<nom-du-composant>/
- Fonctionnalités : src/features/<nom-de-la-fonctionnalite>/
Intégration
Cette compétence peut être intégrée dans :
- CI/CD : Valider les structures de code dans les pipelines de build
- Générateurs de code : Automatiser la création de nouveaux composants en respectant les conventions
- Documentation : Maintenir à jour les décisions architecturales
- Onboarding : Fournir aux nouveaux développeurs une vue d'ensemble claire de l'organisation du code
Technologies prises en charge
- Langages : JavaScript, TypeScript, Python, Java, C#, Go, Rust, PHP
- Frameworks : React, Angular, Vue, Next.js, Django, Spring Boot, .NET, Flutter, Express
- Outils : npm, yarn, pnpm, webpack, vite, eslint, prettier
Contribution
Les contributions sont les bienvenues ! Veuillez consulter le dépôt GitHub pour les directives.
Ce plan est maintenu par la communauté et indépendant de toute plateforme d'agent spécifique.