Que fait oo-component-documentation ?
Créer ou mettre à jour une documentation standardisée de composants orientés objet en utilisant un modèle partagé ainsi que des consignes spécifiques aux modes pour les nouveaux documents et les documents existants.
Vue d'ensemble
Cette compétence automatisée vous aide à générer ou mettre à jour la documentation de vos composants orientés objet selon un format homogène et structuré.
Modes disponibles
- Mode création : Utilisé pour les nouveaux composants. La compétence génère un squelette de documentation complet basé sur le modèle partagé et les métadonnées extraites du code source.
- Mode mise à jour : Destiné aux composants déjà documentés. La compétence lit la documentation existante, identifie les changements dans le code, et met à jour uniquement les sections pertinentes.
Comment ça fonctionne
- Analyse du code source : La compétence inspecte le code du composant (classes, méthodes, propriétés, interfaces) pour en extraire la structure et les annotations JSDoc/PHPDoc.
- Génération du contenu : Elle remplit les sections du modèle partagé (
SKILL.md, template) avec les informations extraites, en respectant les conventions de nommage et les exemples fournis. - Révision et validation : La documentation générée peut être passée en revue avant d'être intégrée au référentiel.
Exemple d'utilisation
# Créer une nouvelle documentation pour un composant
github/oo-component-documentation --action create --component "UserService"
# Mettre à jour la documentation existante
github/oo-component-documentation --action update --component "UserService"
Plateformes supportées
- Claude Code
- Cursor
- Codex
- Autres assistants IA compatibles
Avantages
- Uniformité : Toute la documentation suit le même modèle, facilitant la navigation.
- Réduction des erreurs : Les champs obligatoires sont automatiquement remplis.
- Gain de temps : Plus besoin d'écrire manuellement chaque section.
Ressources
- Documentation officielle : oo-component-documentation
- Modèle partagé :
template.mddans le dépôt