企业官网建设流程全解析

scientific-agent-skills Mermaid Mindmap 思维导图指南：用mindmap语法组织科学概念层级

【免费下载链接】scientific-agent-skillsTurn any AI agent into an AI Scientist. The #1 Agent Skills library for science, used by 190,000+ scientists worldwide. 165 ready-to-use validated skills plus 100+ scientific databases covering biology, chemistry, medicine, and drug discovery. Compatible with Cursor, Claude Code, Codex, Pi, Antigravity, and the open Agent Skills standard.项目地址: https://gitcode.com/GitHub_Trending/cl/scientific-agent-skills

本篇基于 markdown-mermaid-writing 技能的 mindmap 参考文档，系统讲解 Mermaidmindmap思维导图的适用边界、无障碍访问约束、规范书写技巧与可复制模板。读完后，你可以在任何 Markdown 文档（GitHub、GitLab、VS Code 等）中直接写出版本可控、可 diff、可被 AI 与读屏软件解析的概念层级图，而不再依赖二进制图片。

一、Mindmap 在 24 类 Mermaid 图表中的定位

在 scientific-agent-skills 仓库的 markdown-mermaid-writing 技能 中，文档层采用"Mermaid 内嵌 Markdown 为默认与规范格式"的理念：一段用文本表达的关系比图片更有价值——它在 git 中 diff 清晰、无需构建步骤、可被 AI 以极低 token 成本解析，且随时可再转换为成品图片。该技能内置 24 类图表参考，mindmap 是其中的"概念层级 / 头脑风暴"专用类型。

参考文档对 mindmap 的官方定位如下：

这一"最佳用途 / 何时不用"的配对是全部 24 个图表类型参考文档的统一结构。其背后的原则来自 Mermaid 风格指南 的选择表：选最具体的类型，而不是最顺手的类型——不要把所有关系图都默认写成 flowchart，时序交互用 sequence、数据库模型用 ER、概念脑图就用 mindmap。

二、关键无障碍约束：不支持accTitle/accDescr

这是 mindmap 与其他大多数图表类型最重要的差异，也是新手最常踩的坑。

参考文档明确警告：

⚠️ Mindmap不支持accTitle/accDescr。必须在代码块正上方放置一段描述性的斜体Markdown 段落作为无障碍描述。

这与 Mermaid 风格指南 中的无障碍要求一致：所有图表都必须可被读屏软件理解；对于支持accTitle/accDescr的类型直接在图内声明，而对于 Mindmap、Timeline、Quadrant、Sankey 等不支持的类型，则以斜体段落作为替代。

因此一份合格的 mindmap 图表在 Markdown 中的完整形态是：

_描述性斜体段落：说明这张思维导图展示什么、覆盖了哪些关键分类、读者能从中获得什么信息。_ ![mermaid](https://web-api.gitcode.com/mermaid/svg/eNrLzcxLyU0s4FIAAj09PQAnAwP7)

注意斜体段落必须位于代码块正上方，且要能独立承载"读屏用户看不到图形"这一前提下的全部语义信息。

三、标准示例图逐行解析

参考文档给出的生产级示例是一张"平台工程团队关键职责领域"思维导图，按基础设施、开发者体验、安全、可观测性四大领域组织。完整代码如下（保留原文档示例，可直接复制运行）：

思维导图，展示一个平台工程团队的关键职责领域，划分为基础设施、开发者体验、安全与可观测性四个域：

结合语法逐行拆解这张图的设计要点：

1. 根节点root((🏗️ Platform Engineering))：双重圆括号(( ))使根节点渲染为圆形，这是 mindmap 的固定写法。节点文本以 emoji 开头，起到视觉锚点作用。
2. 层级由缩进决定：mindmap 没有 flowchart 那样的-->连线语法，子节点完全靠缩进（空格）表达父子关系。一级分支（☁️ Infrastructure）比根节点多缩进一层，二级子项（Kubernetes clusters）再多缩进一层。
3. 分支头使用 emoji 区分域：☁️（云/基础设施）、🔧（工具/工程）、🔐（安全/加密）、📊（指标/仪表盘）均来自 Mermaid 风格指南 中"项目内同一 emoji 必须表达同一语义"的批准 emoji 集，保证同一文档中多张图的颜色与符号语义一致。
4. 四个主分支、每分支 4 个子项、最深 3 层——这正是文档 Tips 部分量化规则的实例化，后文会展开。

四、五条书写技巧（Tips）逐条展开

参考文档给出的 5 条 Tips 是可直接执行的设计约束，这里结合仓库风格指南补充其背后的理由：

1. 主分支保持 3–4 个，每分支 3–5 个子项。这与 Mermaid 风格指南 中 subgraph 的"2–6 节点为宜"同属一个复杂度管理思想：认知负载超过阈值后图的可读性骤降。3–4 个主分支恰好与示例图一致。
2. 分支头加 emoji 做视觉区分。注意"加在分支头"而不是每个子节点都加——风格指南的 emoji 规则是"每个节点最多一个、放在标签开头、并非每个节点都需要"。mindmap 中把 emoji 集中在一级分支上，是"关键节点才用"原则的典型应用。
3. 嵌套不超过 3 层。根节点（第 1 层）→ 分支（第 2 层）→ 子项（第 3 层）封顶。更深的层级在 mindmap 的自动布局中会挤成难以辨认的长尾，应拆分为多张图或改用 subgraph 化的 flowchart。
4. 根节点使用(( ))圆形。mindmap 语法中不同括号对应不同形状，(( ))圆形是最适合表达"中心概念向外发散"这一心智模型的形式。
5. 始终在上方配一段 Markdown 文字描述以照顾读屏用户。如第二节所述，这是由 mindmap 不支持无障碍标注属性倒逼出的硬性要求，不是可选项。

五、可复制模板（Template）

参考文档随附了一份可直接填充的模板，保留了原文档结构：

（替换为）描述这张思维导图展示的内容及其覆盖的关键分类：

使用时的操作顺序与技能主文档 SKILL.md 定义的核心工作流一致：先读 Mermaid 风格指南（emoji 集、色板、无障碍规则），再打开具体类型文件取模板，最后把成图内联在相关正文段落旁边——而不是集中堆放到一个独立的"图表"章节。

六、结合仓库源码视角：mindmap 规则如何嵌入整个文档体系

从仓库文件结构看，references/diagrams/ 目录下 24 个类型文档（architecture、block、c4、class、flowchart、gantt、mindmap、pie、sequence、timeline、treemap 等）共享同一套约束，mindmap 文档并非孤立存在，以下三条"跨文档规则"在编写 mindmap 时同样必须遵守：

1. 主题中立（Theme neutral）：禁止%%{init}主题指令和行内style——它们会破坏 GitHub 深色模式。mindmap 因此天然"零样式"：全部视觉表达交给缩进层级与 emoji，这恰好与 mindmap 的简洁性需求吻合。
2. emoji 一致性是强制项：批准 emoji 集按"系统与基础设施 / 流程与动作 / 人员与角色 / 状态与结果 / 信息与数据 / 领域专用"六类组织，且明确禁止 🎉 💯 🔥 等装饰性 emoji。模板中的🎯（目标）、📋（清单）、🔧（工具）、📊（指标）均出自该集合。
3. 复杂度分级策略：风格指南将图表按节点数分为 Simple（1–10 节点，平铺）、Moderate（10–20 节点，用 subgraph）、Complex（20–30 节点，subgraph 强制）、Very complex（30+ 节点，拆成总览 + 细节多图）。mindmap 的"3–4 主分支 × 3–5 子项"约束意味着单图节点数通常控制在 ~20 以内；当主题拆解超出这个规模时，从源码结构看更合理的做法是拆成多张 mindmap 各配一段总览文字，而不是塞进一张图。

此外，Markdown 风格指南 中的图表选择表同样把"概念层级、头脑风暴、主题地图"映射到 mindmap，说明无论从"写 Markdown 的人"还是"生成文档的 Agent"视角，mindmap 的触发条件都是一致的。

七、与近邻图表类型的边界辨析

参考文档的"When NOT to use"部分把 mindmap 与 flowchart、timeline 划清边界；结合仓库中其他类型文档，还可以补充一组常见混淆场景：

这条边界对科研写作尤其实用：SKILL.md 在"与 literature-review 技能联动"一节中明确建议，梳理文献版图（landscape of the literature）时应创建Mindmap 概念图，而文献发表时间轴用 Timeline/Gantt、方法论对比用 Quadrant 或 Radar——即"概念关系进 mindmap，量化与时间信息进对应图表"。

八、交付前检查清单

综合参考文档与仓库两份风格指南，mindmap 交付前可按以下清单自检：

• 代码块正上方有一段斜体描述段落（mindmap 无accTitle/accDescr，此段是唯一的无障碍通道）；
• 主分支 3–4 个，每分支子项 3–5 个，嵌套 ≤3 层；
• 根节点使用(( ))圆形语法；
• 分支头 emoji 来自批准集合，同 emoji 同语义，每节点 ≤1 个，无装饰性 emoji；
• 无%%{init}指令、无行内style；
• 内容与主题匹配：是"概念层级"而非"流程 / 时间线 / 数值占比"，若是后者改用对应类型；
• 在 GitHub 浅色与深色模式下均渲染正常（mindmap 零自定义样式，理论上无主题冲突）。

参考资料

• 本文核心内容：skills/markdown-mermaid-writing/references/diagrams/mindmap.md
• 技能总览与三阶段工作流：skills/markdown-mermaid-writing/SKILL.md
• emoji 集、色板、无障碍与复杂度分级：skills/markdown-mermaid-writing/references/mermaid_style_guide.md
• 文档结构规则与图表类型映射表：skills/markdown-mermaid-writing/references/markdown_style_guide.md
• 对比类型参考：treemap.md、pie.md、sankey.md

说明：该技能的内容源自 Apache-2.0 许可的上游项目并已保留署名头（文件首行可见 Source 声明），仓库整体以 MIT 协议分发；文中所有语法、限制与示例均以当前仓库实际文件为准。

【免费下载链接】scientific-agent-skillsTurn any AI agent into an AI Scientist. The #1 Agent Skills library for science, used by 190,000+ scientists worldwide. 165 ready-to-use validated skills plus 100+ scientific databases covering biology, chemistry, medicine, and drug discovery. Compatible with Cursor, Claude Code, Codex, Pi, Antigravity, and the open Agent Skills standard.项目地址: https://gitcode.com/GitHub_Trending/cl/scientific-agent-skills