Agent Skills
返回列表
宝玉图表生成

宝玉图表生成

数据分析 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md 安装规范名 @zcwl/baoyu-diagram;Claude Code 或 CodeBuddy 请按指南将技能ID 填为 zcwl/baoyu-diagram。

技能介绍

它解决了什么问题

把架构草图、流程推理、时列消息等零散需求收敛到一个可复现的 SVG 上。常见工具要么把元素当画板随意摆放,要么导出外部 CSS、字体与资源链接,跨仓库或粘贴进文档后很快失真。更麻烦的是,自动生成的图表常忽视分层与留白:半透明填充盖住连线、区域边界与组件重叠、中文标签溢出。这个技能把「类型布局 + 内联样式 + 分离资源」这件事拆开,按文件约定产出 .svg,并顺手导出 2 倍 PNG。

它如何工作

  1. 识别图类型:从请求与关键词映射到架构、流程、时序、结构、导图、时间线、插画示意或状态机。
  2. 读取参考:解析 SKILL.md 得到 {baseDir},再按类型叠用 references/ 里的布局说明;计划组件、分组、流向与坐标。
  3. 统一样式:调色板使用语义化分类,如边框 #22d3ee 用于前端或输入,#a78bfa 用于存储;文字分标题、名称、说明与箭头标注,行高与字号固定,确保缩放后可读。
  4. 按层绘制:先背景与网格,再区域边界,接连线,放入不透明蒙版 fill="#0f172a",随后组件框、文本、图例与标题。蒙版这一步关键,否则半透明框会盖住箭线,化学联系失效。
  5. 输出规则:单一 .svg,根加 xmlns,不写固定 width/height,viewBox 留足 30px 边距;中文标签走 CJK 字体族并放宽宽度。保存后执行 bun {baseDir}/scripts/main.ts 导出 @2x PNG。

适用边界与注意点

  • 适合静态归档、PR 描述、文档贴图;不提供交互热点与动画,动态数据请另取前端图表。
  • 复杂类图、ER、状态机建议先明确关系语义(组合、聚合、依赖、继承),避免视觉上“像但不对”。
  • 输出仅 SVG 与 PNG,不直接出 PDF;需要矢量嵌入 LaTeX 时可自行再转。
  • 图表一致性来自固定度量与语义色映射,建议在项目里固定输入命名与分类规则,生成结果自然可控。

使用场景

  • 架构评审前,把微服务拓扑、部署边界和数据流向输出为可贴进 PR 的架构图
  • 制定分支策略时,用菱形决策节点还原合并标准与回退路径形成流程图
  • 梳理登录链路时,生成带同步与返回消息的时序图标注用户、网关与存储交互
  • 梳理领域概念时,用中心节点与分支呈现核心术语关系形成思维导图

适合人员

  • 需要在 PR 或架构文档中给出可复现拓扑与组件关系的后端/架构工程师
  • 经常把决策分支整理成流程图并与评审者确认对齐的技术负责人
  • 需要绘制时序图定位消息问题与激活条范围的后端或 SRE 工程师
  • 想把零散需求整理成分类清晰、可追溯关系的产品分析师