
de code-abyss218
Génère des structures README.md et DESIGN.md à partir du code et de la structure d'un module pour accélérer la documentation du projet.
Génère des fichiers README.md et DESIGN.md structurés en analysant le répertoire, le code et les docstrings d'un module. L'outil extrait les noms, descriptions, fonctionnalités, dépendances, exemples d'utilisation et notes d'architecture, produisant un point de départ que les développeurs peuvent affiner. Il supporte plusieurs langages (Python, Go, TypeScript, Rust) et produit une checklist de vérification post-génération.
À utiliser lors de la création d'un nouveau module dont la documentation est manquante, lors de l'intégration de contributeurs ayant besoin d'un aperçu rapide du module, ou comme étape d'une CI qui détecte l'absence de documentation. Il est déclenché lors de la création d'un module ou quand des documents manquants sont détectés.
doc_generator.js sous le dossier scripts/ du repo (has_scripts=true).node scripts/doc_generator.js <module-path> avec l'option --force pour écraser ou --json pour une sortie machine. Le fichier SKILL.md décrit le flux de génération et la checklist post-génération (README : description, fonctionnalités, exemples ; DESIGN : objectifs, décisions, compromis).Idéal pour les environnements d'agents capables d'exécuter des scripts Node.js et d'inspecter les fichiers de dépôt (OpenClaw, Codex/CLI-style agents, Claude Code), et utile comme utilitaire d'automatisation CI pour les assistants orientés développeurs.
Compétence de génération de documentation qui analyse la structure des modules et produit des squelettes README.md et DESIGN.md. Supporte Python (avec extraction de docstrings/classes/fonctions) et une analyse générique basée sur regex pour Go, Rust, TypeScript, JavaScript, Java, C, C++. Le script intégré (doc_generator.js) a été ignoré lors de l'exécution car l'extension .js ne figurait pas dans la liste autorisée du lanceur. Le code est bien structuré avec une séparation claire des préoccupations, un parcours de fichiers respectant le .gitignore et un support multi-langues. Aucune préoccupation de sécurité — opérations sur fichiers purement locales sans appels réseau ni commandes destructrices.
nodeCompétence solide et propre, sans problèmes de sécurité. Le fichier SKILL.md en langue chinoise est complet mais peut limiter l'adoption internationale. Le script est bien écrit et pourrait servir d'utilitaire utile. Le script d'exécution a été ignoré car les fichiers .js ne font pas partie des extensions autorisées du lanceur.