用途：把项目、文档、代码库或概念整理成 Markmap 可渲染的 Markdown 思维导图，先整体后局部地梳理真实内容，必要时校验结构并生成 HTML。
主要能力与规则：根主题说明对象和目的，再展开真实主概念、流程、模块与细节；用材料本身组织导图，不发明空泛分类标题（如“核心概念”“主要模块”等，除非原文即含该词）；每个节点直接子节点默认最多 5 个，是硬约束，仅当用户明确允许更多分支时才可提高上限，且应尽量克制；超过 5 个时合并相近内容并按真实子主题重排；类比可选，放在内容标签之后，不作节点主体；不编造确定性，总结仓库前先看 README、文档、包配置、测试、源码目录和本地脚本；节点用短标签，必要时补有依据的说明；处理复杂仓库或长文档时先读 references/analogy-structure.md。
使用方式：先从整体到局部起草 Markdown，H1 作根标题，## 展开真实主干。用脚本校验：python3 ~/.codex/skills/markmap-analogy-mindmap/scripts/validate_and_render.py input.md --validate-only；用户明确允许更多分支时可加 --max-children 7；需交付 HTML 时用 python3 ~/.codex/skills/markmap-analogy-mindmap/scripts/validate_and_render.py input.md -o output.html。渲染按顺序尝试 markmap、npx --yes markmap-cli、本机 /root/markmap 内已构建 CLI；都不可用时交付已校验 Markdown 并说明 HTML 未生成。
适用场景与限制：适合梳理项目结构、文档要点、代码库与概念关系；创建文件后返回 .md 和 .html 路径，说明检查过的来源与命令结果；除用户要求修改源仓库外只读源材料；中文用户默认输出中文导图，仅在命令、路径、API、包名、术语必须保留英文时使用英文。校验失败先修结构，不要绕过空泛分类与层级过多检查。其余细节资料暂未提供。