用途:生成或修改 Mermaid 图表源码,使其能在 Markdown、README、GitHub、GitLab、wiki 及文档站点中渲染,用图形比文字更清晰地表达关系。
主要能力:从需求或现有资料中提取实体、状态、决策、消息或依赖,选择最小合适的图表类型并生成语法完整的 Mermaid 源码。支持的类型包括:流程或决策用 flowchart TD/LR,时序调用用 sequenceDiagram,状态生命周期用 stateDiagram-v2,类型关系用 classDiagram,数据实体用 erDiagram,排期用 gantt,用户体验用 journey,层级用 mindmap,时间线用 timeline,轻量架构用 architecture-beta 或 flowchart。
使用方式:默认在 Markdown 原生图表场景选用 Mermaid;需要严格 UML 记法、详细 C4 或 .puml 输出时改用 plantuml 技能,安装命令为 npx skills add full-stack-skills/document-skills --skill plantuml;用户明确需要 ProcessOn 或托管可编辑渲染时改用 processon-diagram-generator 技能,安装命令为 npx skills add full-stack-skills/document-skills --skill processon-diagram-generator。上下文已能确定安全默认值时不必让用户选择工具。内联交付返回围栏代码块;文件交付优先使用 docs/diagrams/<descriptive-name>.md,除非仓库已有图表约定,覆盖前需征得同意。
编写规则:为每个节点使用稳定简单的标识符;含标点、括号或特殊字符的标签需加引号;方向保持一致,避免不必要的交叉;决策用菱形并标注分支;时序参与者和消息要明确;除非已知目标平台,避免依赖单一渲染器的样式;图表不可读时应拆分而非缩小标签或堆叠子图;不得为让图表显得完整而编造不支持的事实。
限制:仅在需要语法细节时加载 examples/ 下匹配的单个文件,不要全部加载;交付前校验结构,有渲染器时先渲染;校验声明与图表类型一致、标识符有效唯一、分支与参与者连接正确、围栏闭合。官方资料未提供更多收费、平台或效果信息。