用途:该技能用于创建科学文档、报告、分析、方法章节、README、决策记录等,并强制以 Markdown 内嵌 Mermaid 图表作为默认且规范的格式。核心主张是:写在 .md 文件中的 Mermaid 关系图比任何图片更有价值,因为它是文本,可在 git 中清晰对比,无需构建步骤,可在 GitHub、GitLab、Notion、VS Code 及任意 Markdown 查看器中原生渲染,比同关系的散文描述更省 token,且后续可随时转换为精美图片,但文本版本始终是事实来源。
主要能力:覆盖 24 种 Mermaid 图表类型,几乎可表达所有科学关系,包括流程图、时序图、ER 图、状态图、甘特图、饼图、C4、思维导图、时间线、类图、用户旅程、象限图、需求图、桑基图、XY 图表、块图、看板、架构图、雷达图、树状图、数据包图、Git 图、ZenUML 及复杂组合示例。提供 Markdown 与 Mermaid 两份风格指南、24 个图表类型指南(含范例、技巧与可复制模板)以及 9 类文档模板(决策记录、操作指南、issue、看板、演示、项目文档、拉取请求、研究论文、状态报告)。
使用方式:先判断文档类型并优先套用模板;写任何 .md 前先读 references/markdown_style_guide.md;创建图表前先读 references/mermaid_style_guide.md,再打开对应类型文件。强制规则包括:每个图表加 accTitle 与 accDescr;禁用 %%{init} 指令;禁用内联样式,只用 classDef;每节点最多一个 emoji 且置于标签开头;节点 ID 用 snake_case 并与标签一致;每文档仅一个 H1;emoji 仅用于 H2;外部主张用 [^N] 脚注引用;每个 </details> 后加水平线。图表应内联于相关文字,而非单独“图表”章节。
适用场景:科学文档、报告、分析、手稿、方法章节、README、操作指南、决策记录、项目文档、工作流、数据管道、架构、时间线、关系图,以及任何将纳入版本控制的输出。
限制:结构性或关系性图表不应先用 Python matplotlib、seaborn 或 AI 图像生成,那些属于第二阶段和第三阶段,仅在 Mermaid 无法表达时使用(如真实数据散点图、照片级图像)。雷达图需用 radar-beta 而非 radar,用 axis 定义维度、curve 定义数据系列,且不支持 accTitle/accDescr,需在代码块上方加描述性斜体段落。XY 图表用 xychart-beta,雷达图用 radar-beta,两者语法不同。该技能未提供具体安装命令或收费信息。