Agent Skills
返回列表
宝玉图表

宝玉图表

设计多媒体 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @zcwl/diagram-master-free。

技能介绍

要解决的问题

技术文档、设计评审和架构说明里,图往往是刚需,但手绘或拼贴很难统一暗色主题、语义配色和间距规范。通用绘图工具导出的往往是位图或多文件依赖,嵌入 Markdown 或 Confluence 后不清晰、也不好 diff。

Baoyu Diagram 把输出约束成单个自包含 .svg 文件:内联样式、字体与设计系统写死在文件里,并按类型(架构、流程、时序等)套用固定的分层与排版规则,方便直接放进仓库或文档。

技能如何工作

你说明图表类型与内容,Agent 按 SKILL.md 的流程执行:先判定类型,必要时读 {baseDir}/references/ 下对应说明(如 architecture.md、flowchart.md),再规划组件、分组与流向,按规定的 z-order 写 SVG(背景 → 区域 → 连线 → 遮罩 → 组件 → 文本 → 图例 → 标题)。

配色走语义表:前端 Primary、后端 Secondary、存储 Tertiary 等;流程图/时序图按角色着色而非按技术栈硬套。中文标签会用 JetBrains Mono、Noto Sans SC 等并加宽容器。保存后可用 {baseDir}/scripts/main.ts(Bun/npx)把 SVG 转成默认 @2x PNG。

适用边界与注意点

依赖 Agent 内置 LLM 理解布局与间距,极复杂或主观审美的场景可能需要人工改坐标。类型化图(九类清单内)最稳;说明性插画偏自由布局,一致性弱于架构/流程类。PNG 转换需要本机可执行 Bun 或 npx -y bun,纯 Markdown 环境无法单独完成导出步骤。

使用场景

  • 新服务上线前,要把网关、业务服务与数据库之间的调用关系画成左到右的架构 SVG,放进 RFC
  • 梳理异常处理分支时,需要带菱形决策与 Yes/No 箭头的流程图,并高亮主路径
  • 多人协作接口联调,要把参与方之间的同步/异步消息画成时序图,并标消息序号
  • 数据管道评审会上,用数据流图表示处理节点、外部实体与存储之间的流向

适合人员

  • 负责撰写技术方案、需要在同一暗色规范下反复出架构图的后端或平台工程师
  • 维护内部运维手册、要把审批与回滚步骤固化成流程图 SRE 或技术支持
  • 做课堂或内部分享、需要时序图说明多系统交互顺序的技术写作者
  • 在仓库里用 Markdown 维护设计文档、希望图表是矢量 SVG 便于版本对比的开源维护者