一键思维导图

解决什么问题

手动梳理主题的分支、子主题和行动项时，容易出现这些问题：分支层级零散，主题和行动项混在一起，逻辑不够清晰；整理过程需要反复调整，耗时且易遗漏细节；整理后还需手动配置渲染工具，生成可视化文件的流程繁琐，难以快速验证内容逻辑。

技能如何工作

该技能的核心是将复杂主题转化为层级化的 Mermaid 思维导图，覆盖从内容组织到文件输出的全流程，关键步骤如下：

• 环境预检：首次渲染前通过 command -v mmdc && mmdc --version 检查本机 Mermaid CLI（mmdc）是否可用，确保渲染环境就绪；若未安装，会引导用户安装（未经明确授权不代装）。
• 内容组织：遵循统一的结构规则，根节点仅保留一个核心主题，一级节点控制在易扫描的数量范围；同级节点保持相近粒度，行动项以动词开头；复杂内容按「目标、现状、方案、执行、风险」等维度拆分分支，避免长段落堆砌。
• 渲染导出：将整理好的内容生成为 Mermaid 源码并保存为 .mmd 文件；默认保存到当前项目的 docs/mermaid/ 目录（目录不存在时自动创建），若用户指定位置则按要求保存；通过 mmdc 渲染为 SVG 等格式的可视化文件。
• 结果交付：交付时提供源码、导出文件的绝对路径链接，以及本次使用的 mmdc 版本，方便用户定位和复用。

适用边界与注意点

• 授权限制：若本机未安装 mmdc，需用户明确授权后再引导安装，不会擅自代装；若本机 mmdc 版本距离 npm 最新版本超过 3 个发布版本，会先询问用户是否升级，或确认继续使用旧版本，避免版本兼容问题。
• 渲染错误排查：渲染失败时会区分两种错误类型——Mermaid 语法错误（需调整源码结构）和 Puppeteer 浏览器依赖错误（需补充浏览器依赖），避免混淆问题根源。
• 内容复杂度：不适合处理过于零散、无明确逻辑关联的内容，建议先梳理核心主题与分支的关联，再使用该技能生成思维导图，保证层级清晰度。

通过自动化的内容组织和渲染流程，该技能能减少手动整理思维导图的重复劳动，让主题逻辑的梳理和可视化更高效。