cygnusfear/file-name-wizard

Que fait file-name-wizard ?

Auditez tous les noms de fichiers et les conventions de nommage dans la base de code par rapport aux normes AGENTS.md et aux schémas courants. Utilisez-le lorsque l'utilisateur demande de vérifier les conventions de nommage, d'auditer les noms de fichiers, de trouver des incohérences de nommage ou de valider les schémas de nommage de fichiers.

Fonctionnement

Ce skill parcourt la base de code en utilisant des commandes shell (comme find, ls, grep) pour collecter tous les noms de fichiers. Ensuite, il analyse chaque nom de fichier et le compare aux règles définies dans le fichier AGENTS.md (s'il existe) ou aux conventions de nommage standards suivantes :

• kebab-case : ex. mon-composant.js
• snake_case : ex. mon_fichier_test.py
• camelCase : ex. monFichier.js
• PascalCase : ex. MonComposant.vue
• Conventions de dossier : ex. components/, utils/, pages/

Utilisation

1. Assurez-vous que le fichier AGENTS.md est présent à la racine du projet (facultatif mais recommandé).
2. Exécutez la commande suivante dans le terminal :

file-name-wizard audit

3. Le skill générera un rapport listant :
   • Les fichiers conformes aux conventions.
   • Les fichiers non conformes avec la raison (ex. "utilise du camelCase au lieu du kebab-case").
   • Les suggestions de renommage.

Exemple de sortie

Rapport d'audit des noms de fichiers
====================================
Conventions utilisées : AGENTS.md (kebab-case)

Fichiers conformes :
  - src/components/button.js
  - src/utils/helpers.js

Fichiers non conformes :
  - src/views/MyPage.vue (PascalCase -> devrait être my-page.vue)
  - src/data/user_data.py (snake_case -> devrait être user-data.py)

Suggestions :
  - Renommer 'MyPage.vue' en 'my-page.vue'
  - Renommer 'user_data.py' en 'user-data.py'

Personnalisation

Vous pouvez spécifier des conventions personnalisées en modifiant AGENTS.md :

## Conventions de nommage

- Les fichiers JavaScript doivent utiliser le kebab-case.
- Les fichiers Vue doivent utiliser le PascalCase pour les composants.
- Les dossiers doivent être en minuscules avec des traits d'union.
- Les fichiers de test doivent se terminer par `.test.js`.

Limites

• Le skill ne modifie pas les fichiers ; il se contente d'auditer et de suggérer.
• Il ne vérifie pas le contenu des fichiers, seulement leurs noms.
• Assurez-vous que les outils requis (find, grep, etc.) sont disponibles dans l'environnement.

Support

Pour toute question ou amélioration, ouvrez une issue sur le dépôt GitHub : cygnusfear/file-name-wizard