用途:该技能是 generate_diagram 工具调用的强制前置步骤,必须在每次调用前加载,不能直接调用 generate_diagram。它把用户需求路由到对应的图表类型指南,并设定通用约束,最终由 generate_diagram 接收 Mermaid.js 语法并生成可编辑的 FigJam 图表。
主要能力:支持的图表类型包括 flowchart、sequenceDiagram、stateDiagram/stateDiagram-v2、gantt、erDiagram。不支持的包括饼图、思维导图、维恩图、类图、journey、时间线、象限图、C4、git graph、需求图等,遇到应直接告知用户不支持而非调用失败。技能还提供按类型路由(架构流程图读 references/architecture.md,流程图读 references/flowchart.md,时序图读 references/sequence.md,ER 图读 references/erd.md,状态图读 references/state.md,甘特图读 references/gantt.md),以及通用约束:源中不得有 emoji、标签内不得用 \n 或 HTML 标签、保留字 end/subgraph/graph 不可作节点 ID、节点 ID 用 camelCase 且无空格、标签特殊字符需引号包裹;时序图 Note 会被渲染器静默剥离,甘特图 classDef/class 等样式会被预处理剥离。
使用方式:先确认 generate_diagram 是否适用,再选图表类型并读取对应 reference;写 Mermaid 前从源码、用户文档、已有 Figma/FigJam 文件或其他 MCP 工具获取真实上下文,信息不足时向用户提一两个聚焦问题。调用参数:必填 name、mermaidSyntax;可选 userIntent、useArchitectureLayoutCode(仅架构图)、fileKey。不要先调用 create_new_file。生成后展示返回链接;如需便签注释或按节点着色,可结合 use_figma 使用混合工作流(读 references/workflow.md),且只能用 FigJam 支持的 API,不可调用 figma.createPage()。迭代时复用同一 fileKey 避免产生多个草稿文件。同一图失败两次后应停止重生成,询问具体问题或建议在 Figma 中手动编辑。
限制:无法更改已有图表的字体、无法移动单个形状、无法逐节点编辑;内容级修改通常重新生成更快。缺失信息不得编造,应留空并告知用户。