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 的官方定位如下属性取值语法关键字mindmap最佳用途头脑风暴Brainstorming、概念组织concept organization、知识层级knowledge hierarchies、主题拆解topic breakdown不适用场景顺序流程应改用 Flowchart、时间线应改用 Timeline这一最佳用途 / 何时不用的配对是全部 24 个图表类型参考文档的统一结构。其背后的原则来自 Mermaid 风格指南 的选择表选最具体的类型而不是最顺手的类型——不要把所有关系图都默认写成 flowchart时序交互用 sequence、数据库模型用 ER、概念脑图就用 mindmap。二、关键无障碍约束不支持accTitle/accDescr这是 mindmap 与其他大多数图表类型最重要的差异也是新手最常踩的坑。参考文档明确警告⚠️ Mindmap不支持accTitle/accDescr。必须在代码块正上方放置一段描述性的斜体Markdown 段落作为无障碍描述。这与 Mermaid 风格指南 中的无障碍要求一致所有图表都必须可被读屏软件理解对于支持accTitle/accDescr的类型直接在图内声明而对于 Mindmap、Timeline、Quadrant、Sankey 等不支持的类型则以斜体段落作为替代。因此一份合格的 mindmap 图表在 Markdown 中的完整形态是_描述性斜体段落说明这张思维导图展示什么、覆盖了哪些关键分类、读者能从中获得什么信息。_ 注意斜体段落必须位于代码块正上方且要能独立承载读屏用户看不到图形这一前提下的全部语义信息。三、标准示例图逐行解析参考文档给出的生产级示例是一张平台工程团队关键职责领域思维导图按基础设施、开发者体验、安全、可观测性四大领域组织。完整代码如下保留原文档示例可直接复制运行思维导图展示一个平台工程团队的关键职责领域划分为基础设施、开发者体验、安全与可观测性四个域结合语法逐行拆解这张图的设计要点根节点root((️ Platform Engineering))双重圆括号(( ))使根节点渲染为圆形这是 mindmap 的固定写法。节点文本以 emoji 开头起到视觉锚点作用。层级由缩进决定mindmap 没有 flowchart 那样的--连线语法子节点完全靠缩进空格表达父子关系。一级分支☁️ Infrastructure比根节点多缩进一层二级子项Kubernetes clusters再多缩进一层。分支头使用 emoji 区分域☁️云/基础设施、工具/工程、安全/加密、指标/仪表盘均来自 Mermaid 风格指南 中项目内同一 emoji 必须表达同一语义的批准 emoji 集保证同一文档中多张图的颜色与符号语义一致。四个主分支、每分支 4 个子项、最深 3 层——这正是文档 Tips 部分量化规则的实例化后文会展开。四、五条书写技巧Tips逐条展开参考文档给出的 5 条 Tips 是可直接执行的设计约束这里结合仓库风格指南补充其背后的理由主分支保持 3–4 个每分支 3–5 个子项。这与 Mermaid 风格指南 中 subgraph 的2–6 节点为宜同属一个复杂度管理思想认知负载超过阈值后图的可读性骤降。3–4 个主分支恰好与示例图一致。分支头加 emoji 做视觉区分。注意加在分支头而不是每个子节点都加——风格指南的 emoji 规则是每个节点最多一个、放在标签开头、并非每个节点都需要。mindmap 中把 emoji 集中在一级分支上是关键节点才用原则的典型应用。嵌套不超过 3 层。根节点第 1 层→ 分支第 2 层→ 子项第 3 层封顶。更深的层级在 mindmap 的自动布局中会挤成难以辨认的长尾应拆分为多张图或改用 subgraph 化的 flowchart。根节点使用(( ))圆形。mindmap 语法中不同括号对应不同形状(( ))圆形是最适合表达中心概念向外发散这一心智模型的形式。始终在上方配一段 Markdown 文字描述以照顾读屏用户。如第二节所述这是由 mindmap 不支持无障碍标注属性倒逼出的硬性要求不是可选项。五、可复制模板Template参考文档随附了一份可直接填充的模板保留了原文档结构替换为描述这张思维导图展示的内容及其覆盖的关键分类使用时的操作顺序与技能主文档 SKILL.md 定义的核心工作流一致先读 Mermaid 风格指南emoji 集、色板、无障碍规则再打开具体类型文件取模板最后把成图内联在相关正文段落旁边——而不是集中堆放到一个独立的图表章节。六、结合仓库源码视角mindmap 规则如何嵌入整个文档体系从仓库文件结构看references/diagrams/ 目录下 24 个类型文档architecture、block、c4、class、flowchart、gantt、mindmap、pie、sequence、timeline、treemap 等共享同一套约束mindmap 文档并非孤立存在以下三条跨文档规则在编写 mindmap 时同样必须遵守主题中立Theme neutral禁止%%{init}主题指令和行内style——它们会破坏 GitHub 深色模式。mindmap 因此天然零样式全部视觉表达交给缩进层级与 emoji这恰好与 mindmap 的简洁性需求吻合。emoji 一致性是强制项批准 emoji 集按系统与基础设施 / 流程与动作 / 人员与角色 / 状态与结果 / 信息与数据 / 领域专用六类组织且明确禁止 等装饰性 emoji。模板中的目标、清单、工具、指标均出自该集合。复杂度分级策略风格指南将图表按节点数分为 Simple1–10 节点平铺、Moderate10–20 节点用 subgraph、Complex20–30 节点subgraph 强制、Very complex30 节点拆成总览 细节多图。mindmap 的3–4 主分支 × 3–5 子项约束意味着单图节点数通常控制在 ~20 以内当主题拆解超出这个规模时从源码结构看更合理的做法是拆成多张 mindmap 各配一段总览文字而不是塞进一张图。此外Markdown 风格指南 中的图表选择表同样把概念层级、头脑风暴、主题地图映射到 mindmap说明无论从写 Markdown 的人还是生成文档的 Agent视角mindmap 的触发条件都是一致的。七、与近邻图表类型的边界辨析参考文档的When NOT to use部分把 mindmap 与 flowchart、timeline 划清边界结合仓库中其他类型文档还可以补充一组常见混淆场景你想表达的内容正确选择为什么不是 mindmap步骤、分支、判断逻辑Flowchart存在方向与先后关系mindmap 只有发散没有流向按时间排列的事件、里程碑Timeline主轴是时间轴不是从中心向外发散概念树、知识框架、主题拆解Mindmap无方向、无时序纯粹的结构化发散带数值的层级占比预算、磁盘用量Treemaptreemap 的矩形面积编码数值大小mindmap 不编码数值各部分占整体的比例Piepie 表达的是多少mindmap 表达的是包含什么流量 / 资源流向分布Sankeysankey 有明确的源 → 汇流动语义这条边界对科研写作尤其实用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.mdemoji 集、色板、无障碍与复杂度分级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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 scientific-agent-skills Mermaid Mindmap 思维导图指南：用 `mindmap` 语法组织科学概念层级
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 的官方定位如下属性取值语法关键字mindmap最佳用途头脑风暴Brainstorming、概念组织concept organization、知识层级knowledge hierarchies、主题拆解topic breakdown不适用场景顺序流程应改用 Flowchart、时间线应改用 Timeline这一最佳用途 / 何时不用的配对是全部 24 个图表类型参考文档的统一结构。其背后的原则来自 Mermaid 风格指南 的选择表选最具体的类型而不是最顺手的类型——不要把所有关系图都默认写成 flowchart时序交互用 sequence、数据库模型用 ER、概念脑图就用 mindmap。二、关键无障碍约束不支持accTitle/accDescr这是 mindmap 与其他大多数图表类型最重要的差异也是新手最常踩的坑。参考文档明确警告⚠️ Mindmap不支持accTitle/accDescr。必须在代码块正上方放置一段描述性的斜体Markdown 段落作为无障碍描述。这与 Mermaid 风格指南 中的无障碍要求一致所有图表都必须可被读屏软件理解对于支持accTitle/accDescr的类型直接在图内声明而对于 Mindmap、Timeline、Quadrant、Sankey 等不支持的类型则以斜体段落作为替代。因此一份合格的 mindmap 图表在 Markdown 中的完整形态是_描述性斜体段落说明这张思维导图展示什么、覆盖了哪些关键分类、读者能从中获得什么信息。_ 注意斜体段落必须位于代码块正上方且要能独立承载读屏用户看不到图形这一前提下的全部语义信息。三、标准示例图逐行解析参考文档给出的生产级示例是一张平台工程团队关键职责领域思维导图按基础设施、开发者体验、安全、可观测性四大领域组织。完整代码如下保留原文档示例可直接复制运行思维导图展示一个平台工程团队的关键职责领域划分为基础设施、开发者体验、安全与可观测性四个域结合语法逐行拆解这张图的设计要点根节点root((️ Platform Engineering))双重圆括号(( ))使根节点渲染为圆形这是 mindmap 的固定写法。节点文本以 emoji 开头起到视觉锚点作用。层级由缩进决定mindmap 没有 flowchart 那样的--连线语法子节点完全靠缩进空格表达父子关系。一级分支☁️ Infrastructure比根节点多缩进一层二级子项Kubernetes clusters再多缩进一层。分支头使用 emoji 区分域☁️云/基础设施、工具/工程、安全/加密、指标/仪表盘均来自 Mermaid 风格指南 中项目内同一 emoji 必须表达同一语义的批准 emoji 集保证同一文档中多张图的颜色与符号语义一致。四个主分支、每分支 4 个子项、最深 3 层——这正是文档 Tips 部分量化规则的实例化后文会展开。四、五条书写技巧Tips逐条展开参考文档给出的 5 条 Tips 是可直接执行的设计约束这里结合仓库风格指南补充其背后的理由主分支保持 3–4 个每分支 3–5 个子项。这与 Mermaid 风格指南 中 subgraph 的2–6 节点为宜同属一个复杂度管理思想认知负载超过阈值后图的可读性骤降。3–4 个主分支恰好与示例图一致。分支头加 emoji 做视觉区分。注意加在分支头而不是每个子节点都加——风格指南的 emoji 规则是每个节点最多一个、放在标签开头、并非每个节点都需要。mindmap 中把 emoji 集中在一级分支上是关键节点才用原则的典型应用。嵌套不超过 3 层。根节点第 1 层→ 分支第 2 层→ 子项第 3 层封顶。更深的层级在 mindmap 的自动布局中会挤成难以辨认的长尾应拆分为多张图或改用 subgraph 化的 flowchart。根节点使用(( ))圆形。mindmap 语法中不同括号对应不同形状(( ))圆形是最适合表达中心概念向外发散这一心智模型的形式。始终在上方配一段 Markdown 文字描述以照顾读屏用户。如第二节所述这是由 mindmap 不支持无障碍标注属性倒逼出的硬性要求不是可选项。五、可复制模板Template参考文档随附了一份可直接填充的模板保留了原文档结构替换为描述这张思维导图展示的内容及其覆盖的关键分类使用时的操作顺序与技能主文档 SKILL.md 定义的核心工作流一致先读 Mermaid 风格指南emoji 集、色板、无障碍规则再打开具体类型文件取模板最后把成图内联在相关正文段落旁边——而不是集中堆放到一个独立的图表章节。六、结合仓库源码视角mindmap 规则如何嵌入整个文档体系从仓库文件结构看references/diagrams/ 目录下 24 个类型文档architecture、block、c4、class、flowchart、gantt、mindmap、pie、sequence、timeline、treemap 等共享同一套约束mindmap 文档并非孤立存在以下三条跨文档规则在编写 mindmap 时同样必须遵守主题中立Theme neutral禁止%%{init}主题指令和行内style——它们会破坏 GitHub 深色模式。mindmap 因此天然零样式全部视觉表达交给缩进层级与 emoji这恰好与 mindmap 的简洁性需求吻合。emoji 一致性是强制项批准 emoji 集按系统与基础设施 / 流程与动作 / 人员与角色 / 状态与结果 / 信息与数据 / 领域专用六类组织且明确禁止 等装饰性 emoji。模板中的目标、清单、工具、指标均出自该集合。复杂度分级策略风格指南将图表按节点数分为 Simple1–10 节点平铺、Moderate10–20 节点用 subgraph、Complex20–30 节点subgraph 强制、Very complex30 节点拆成总览 细节多图。mindmap 的3–4 主分支 × 3–5 子项约束意味着单图节点数通常控制在 ~20 以内当主题拆解超出这个规模时从源码结构看更合理的做法是拆成多张 mindmap 各配一段总览文字而不是塞进一张图。此外Markdown 风格指南 中的图表选择表同样把概念层级、头脑风暴、主题地图映射到 mindmap说明无论从写 Markdown 的人还是生成文档的 Agent视角mindmap 的触发条件都是一致的。七、与近邻图表类型的边界辨析参考文档的When NOT to use部分把 mindmap 与 flowchart、timeline 划清边界结合仓库中其他类型文档还可以补充一组常见混淆场景你想表达的内容正确选择为什么不是 mindmap步骤、分支、判断逻辑Flowchart存在方向与先后关系mindmap 只有发散没有流向按时间排列的事件、里程碑Timeline主轴是时间轴不是从中心向外发散概念树、知识框架、主题拆解Mindmap无方向、无时序纯粹的结构化发散带数值的层级占比预算、磁盘用量Treemaptreemap 的矩形面积编码数值大小mindmap 不编码数值各部分占整体的比例Piepie 表达的是多少mindmap 表达的是包含什么流量 / 资源流向分布Sankeysankey 有明确的源 → 汇流动语义这条边界对科研写作尤其实用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.mdemoji 集、色板、无障碍与复杂度分级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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考