fengyunzaidushi/markmap-skill

Mindmap Markmap priorisant le contenu

Organisez un projet, un document, une base de code ou un concept en Markdown prêt à être rendu avec Markmap, avec validation de la structure et génération HTML si nécessaire.

Règles fondamentales

• Du global au local : le nœud racine décrit l'objet et l'objectif, puis déploie les vrais concepts principaux, processus, modules et détails.
• Utilisez le matériel lui-même pour organiser la mindmap. N'inventez pas de titres de catégorie vagues pour faciliter la lecture par des débutants.
• Supprimez les titres qui ne servent qu'à catégoriser, par exemple « Positionnement du projet », « Mécanismes », « Panorama du développement », « Concepts clés », « Modules principaux », « Cas d'usage », sauf si ces termes font partie du texte original.
• Chaque nœud parent a au maximum 7 enfants directs ; privilégiez environ 5, et n'étendez à 6-7 que si le contenu l'exige réellement.
• Ne déployez pas plus de 7 branches même si le contenu réel est volumineux ; regroupez plutôt selon les véritables sous-thèmes du matériel.
• Si un niveau semble nécessiter plus de 7 branches, fusionnez d'abord les sujets similaires, puis réorganisez selon l'ordre « global -> groupe -> détails locaux ».
• Les analogies sont optionnelles. Utilisez-les uniquement si elles aident vraiment la mémorisation, et placez-les après l'étiquette de contenu ; ne faites pas de l'analogie le nœud principal.
• N'inventez pas de certitudes. Avant de résumer un dépôt, lisez le README, la documentation, la configuration du package, les tests, les sources et les scripts locaux.
• Gardez la mindmap concise. Utilisez des étiquettes de contenu courtes pour les nœuds, et ajoutez une brève explication factuelle si nécessaire.

Lorsque vous traitez un dépôt complexe ou un long document, lisez d'abord references/analogy-structure.md.

Flux de travail

1. Examinez d'abord le matériel.
   • Pour un dépôt : lisez README, AGENTS.md/CLAUDE.md, la configuration du package, la documentation et la structure des répertoires de premier niveau.
   • Pour un document : repérez d'abord le sujet, les affirmations, les sections, les concepts récurrents et les termes à mémoriser.
2. Rédigez le Markdown du global au local.
   • Utilisez un titre H1 pour le nœud racine décrivant l'objet.
   • Utilisez ## pour déployer les vraies branches principales du contenu, sans « seaux de catégorisation pour le lecteur ».
   • Pour chaque nœud, privilégiez les vrais concepts, systèmes, processus, chemins de fichiers, API, affirmations ou responsabilités issus du matériel.
   • Ne développez que lorsque les détails aident à la compréhension ; ne forcez pas de branches supplémentaires.
   • Chaque nœud parent a au maximum 7 enfants directs (idéalement environ 5) ; au-delà, regroupez selon les véritables sous-thèmes.
3. Validez le Markdown avec le script :

python3 ~/.codex/skills/markmap-analogy-mindmap/scripts/validate_and_render.py input.md --validate-only

4. Si un rendu HTML est nécessaire, utilisez :

python3 ~/.codex/skills/markmap-analogy-mindmap/scripts/validate_and_render.py input.md -o output.html

5. Si la validation échoue, corrigez d'abord la structure de la mindmap. Ne contournez pas les vérifications des « titres vagues » et du « trop grand nombre de branches par niveau » sauf si l'utilisateur demande explicitement une mindmap non standard.

Rendu Markmap

Le script tentera successivement :

1. markmap
2. npx --yes markmap-cli
3. Le CLI compilé localement dans /root/markmap

Si aucun moteur de rendu n'est disponible, le Markdown validé est livré en l'état, en précisant que le HTML n'a pas été généré.

Exigences de sortie

• Après création des fichiers, renvoyez les chemins du .md et du .html.
• Indiquez les sources consultées et les résultats des commandes de validation/rendu.
• En lecture seule sur le matériel source, sauf si l'utilisateur demande des modifications.
• Par défaut, produisez la mindmap en chinois (langue de l'utilisateur) ; n'utilisez l'anglais que pour les commandes, chemins, API, noms de paquets et termes techniques qui doivent rester en anglais.