fengyunzaidushi/markmap-skill

Inhaltspriorisierte Markmap-Mindmap

Organisiert Projekte, Dokumente, Codebasen oder Konzepte in mit Markmap renderbarem Markdown und kann bei Bedarf die Struktur validieren und HTML generieren.

Kernregeln

• Zuerst das Ganze, dann die Details: Der Wurzelknoten beschreibt Objekt und Zweck, dann werden die eigentlichen Hauptkonzepte, Prozesse, Module und Details ausgebreitet.
• Verwende echtes Material zur Strukturierung. Erfinde keine allgemeinen Kategorietitel, nur um es für Einsteiger einfacher zu machen.
• Entferne rein klassifizierende Titel wie „Projektpositionierung““, „Funktionsweise““, „Entwicklungslandschaft““, „Kernkonzepte““, „Hauptmodule““, „Einsatzszenarien“ – es sei denn, diese Begriffe sind Teil des Originaltexts.
• Maximal 7 direkte Kinder pro Knoten; bevorzugt etwa 5; erweitere nur auf 6–7, wenn der Inhalt es wirklich erfordert.
• Platziere nicht mehr als 7 Zweige auf einer Ebene, auch wenn der echte Inhalt umfangreich ist; gruppiere stattdessen nach echten Unterthemen.
• Wenn eine Ebene mehr als 7 Zweige zu erfordern scheint, fasse ähnliche Inhalte zusammen und strukturiere nach „Gesamtbild → Gruppe → Detail“ um.
• Analogien sind optional. Verwende sie nur, wenn sie wirklich beim Verständnis helfen; setze sie nach dem Inhalts-Label, nicht als Knotenhaupt.
• Behaupte nichts ohne Beleg. Lies vor dem Zusammenfassen eines Repos README, Dokumentation, Paketkonfigurationen, Tests, Quellcode-Verzeichnisse und lokale Skripte.
• Halte die Mindmap übersichtlich. Knoten verwenden kurze Inhalts-Label; ergänze ggf. einen kurzen, belegten Kommentar.

Bei komplexen Repos oder langen Dokumenten lies zuerst references/analogy-structure.md.

Arbeitsablauf

1. Untersuche zunächst das Material.
   • Repo: Lies README, AGENTS.md/CLAUDE.md, Paketkonfigurationen, Dokumentation und das oberste Verzeichnis.
   • Dokument: Suche nach Thema, Behauptungen, Abschnitten, wiederkehrenden Konzepten und merkenswerten Begriffen.
2. Entwurf des Markdowns vom Großen ins Kleine.
   • Verwende eine H1-Überschrift als Wurzel, die das Objekt beschreibt.
   • Verwende ## für die Hauptäste des echten Inhalts – keine „Kategorien-Eimer“ für den Leser.
   • Jeder Knoten bevorzugt echte Konzepte, Systeme, Prozesse, Dateipfade, APIs, Behauptungen oder Verantwortlichkeiten aus dem Material.
   • Verzweige nur weiter, wenn Details zum Verständnis beitragen; erzwinge keine Zweige.
   • Jeder Elternknoten hat maximal 7 direkte Kinder, bevorzugt etwa 5; bei mehr als 7 nach echten Unterthemen neu gruppieren.
3. Validiere das Markdown mit dem Skript:

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

4. Wenn HTML benötigt wird, rendere die Markmap:

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

5. Wenn die Validierung fehlschlägt, korrigiere zuerst die Mindmap-Struktur. Umgehe die Prüfungen auf „leere Kategorien“ und „zu viele Zweige“ nur, wenn der Benutzer explizit eine nicht standardgemäße Mindmap wünscht.

Markmap-Rendering

Das Skript versucht folgende Renderer in dieser Reihenfolge:

1. markmap
2. npx --yes markmap-cli
3. Lokal gebautes CLI unter /root/markmap

Wenn kein Renderer verfügbar ist, wird das validierte Markdown als Liefergegenstand ausgegeben und darauf hingewiesen, dass kein HTML erzeugt wurde.

Ausgabeanforderungen

• Nach dem Erstellen der Dateien Pfade zur .md und .html ausgeben.
• Angeben, welche Quellen überprüft wurden und die Ergebnisse der Validierung/Render-Befehle.
• Nur Lesezugriff auf das Quellmaterial, es sei denn, der Benutzer fordert Änderungen am Quell-Repo.
• Für chinesische Benutzer standardmäßig chinesische Mindmap ausgeben; Englisch nur für Befehle, Pfade, APIs, Paketnamen und Fachbegriffe.