图表工坊
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_23d092a5/ibz-flowchart。
技能介绍
问题:当图表需要回归文本
在沟通架构和流程时,很多人习惯直接让图像生成模型“画一张流程图”。问题在于,这类模型擅长生成像素,却不擅长保证文字准确、连线合规、结构可回溯。一旦图中包含中英文混排的标签、细密的连线或明确的语义(比如数据库存储、第三方外部系统),文字常常出现错别字,连接线也容易断裂,整张图更像不可编辑的黑盒。对需要反复修改的工程文档来说,这是难以接受的。
工作方式:结构化优先的 Mermaid 渲染
这项技能的核心主张是:图表应当是结构化文本,而不是一次性图片。 它基于 Mermaid 语法生成 .mmd 源码,通过本地渲染脚本输出 PNG 和 SVG。默认采用 Aurora 外观:柔和的蓝紫薄荷色画布、冷白玻璃质感的卡片,以及清晰的层次感。渲染器会自动选择方向与预设,并按语义插入对应的节点类型(startEnd、decision、store 等)。
工作流程大致三步:
- 识别图表种类:信息结构对应 Mermaid 类型。流程用
flowchart TD,分层架构用flowchart LR搭配浅层子图,时序交互用sequenceDiagram,类与接口继承用classDiagram,实体关系用erDiagram,甘特依赖用gantt,等等。 - 先简化再绘制:每个节点只承载一个动作,标签用动作导向的短文本;实现细节、SQL、类名、长解释一律放到节点之外。主路径要清晰,异常分支要浅;源码中不允许存在贯穿画布的加高回环边,重试闭环应拆成独立的明细图。
- 渲染与交付:源码以 UTF-8
.mmd保存,渲染脚本生成 PNG(供飞书和文档使用)和 SVG(按需用于可缩放或高分辨率场景)。默认策略是“渲染干净即停”——不打开 PNG 做视觉复核;仅在渲染器报出 WARNING 或用户明确要求时,才读取图片检查。
适用边界与注意点
这项技能不承诺“一键出图”的奇迹,它受限于几个现实:
渲染器发出的 WARNING 不是无害噪音,而是必须修复或向用户说明的门槛。Opaque 回退、异常主题布局等问题都需要回到 .mmd 修复后重新渲染。
回环边的约束非常严格:重试循环应当结束在“修改后重新提交”“取下一题继续”这类终端节点,而不是绕回早期步骤形成画布级别的闭环。超过约 10 个节点或存在大量交叉边的关系图,应当拆分。
pie 尽量不超过六片,mindmap 尽量三层以内,kanban 限制在 3–6 列,Sankey 链接必须目的明确,XY 图表类别轴需可读。
文件路径优先采用用户提供的路径,否则保存在 tmp/flowcharts/-.{mmd,png};返回时给绝对路径,除非用户特别要求,不要把大段 Mermaid 源码粘贴进对话。
适合需要反复维护、精确控制的图表场景。对于一次性、视觉优先、不关心可编辑性的海报式图形,它不是合适的工具。
使用场景
- 撰写技术文档时,需要把登录、权限校验和异常分支画成可编辑的 Mermaid 流程图
- 设计后端架构时,需要用 flowchart LR 分层展示微服务调用、Redis 缓存和数据库存储
- 梳理发布计划时,需要根据任务时长和依赖关系生成甘特图,标注里程碑
- 编写培训材料时,需要把知识层级整理为 mindmap,并输出适合文档插入的 PNG
适合人员
- 后端工程师:需要把接口调用链路、异常分支和存储节点画清楚,便于评审与排查
- 架构师:需要用可编辑的分层流程图表达系统边界、外部服务和数据流
- 技术文档作者:需要在文档中解释流程、类继承或实体关系,并保留可修改的 Mermaid 源文件
- 项目经理:需要根据任务时长和依赖关系制作甘特图,明确排期与关键里程碑