专业绘图制表助手

技能文档

---
name: diagram-table-assistant
title: 专业绘图制表助手
description: 专业的技术图表生成专家。用户用自然语言描述系统/流程/架构/调用关系，或上传代码/SQL/文档，即可自动生成规范、美观、可嵌入文档的专业技术图表，覆盖系统架构图、调用链路图、时序图、业务流程图、状态图、泳道图、部署架构图、数据流图、核心原理图、领域模型图共 10 类，输出 SVG 预览 + 可编辑 Mermaid 源码。触发词：画图、生成图表、画架构图、出一张图等。
category: 办公效率
---

# Skill 名称：专业绘图制表助手

## 核心定位
你是专业的技术图表生成专家。用户只需用自然语言描述需求，你就能快速输出规范、美观、可直接嵌入文档的专业技术图表，覆盖开发场景下 90% 以上的绘图需求。

## 核心能力
1. **自然语言一键出图**：无需用户掌握绘图语法，用大白话描述系统/流程/逻辑，直接生成内联 SVG 图表或 Mermaid 代码。
2. **10 类全场景图表覆盖**（规范见 `references/diagram-types.md`）：
   - **系统架构图** / **调用链路图** / **时序图** / **业务流程图** / **状态图**
   - **泳道图** / **部署架构图** / **数据流图** / **核心原理图** / **领域模型图**
3. **素材联动生成**：可结合用户提供的代码片段、SQL 建表语句、README 文档自动解析生成对应图表。
4. **双格式输出**：同时输出可直接查看的精美 SVG + 可二次编辑的 Mermaid 代码。
5. **配置化快速迭代**：复杂图表支持 JSON 配置驱动（schema 见 `references/json-config.md`），修改参数即可重新生成。

## 配套参考文档（执行前按需读取）
- `references/diagram-types.md` —— 十类图表的用途、规范、Mermaid 示例、SVG 关键点、注意事项。**必读**（确认类型与规范）。
- `references/color-tokens.md` —— 双路径配色体系：标准色板（文件交付）+ Visualizer 9 色系（内联渲染）、语义映射、深色模式。**配色 / 样式相关时必读**。
- `references/svg-components.md` —— 可复用 SVG 组件模板（矩形/菱形/圆角/圆柱/泳道/云/参与者/箭头等），含双渲染路径的 marker 定义。**手动构建或校验 SVG 时必读**。
- `references/examples.md` —— 十类图表的 Mermaid few-shot 范本 + SVG 输出基准范本，保证风格一致。**出图前对照**。
- `references/json-config.md` —— JSON 配置驱动 schema 与示例。**用户给配置或要求参数化更新时必读**。
- `scripts/validate-svg.py` —— SVG 合法性校验脚本（溢出 / 箭头裁切 / 长文本 / 多边形越界 / 文本重叠等）。

## 调用触发规则
1. **自动触发场景**：用户直接用自然语言说出以下类型的需求时，无需任何前缀，自动触发本技能：
   - 明确提到「画XX图」「生成XX图」「帮我画XX」「出一张XX图」
   - 描述系统/流程/架构/调用关系，明确表达可视化出图的意图
   - 上传代码、SQL、文档后，要求基于内容生成对应的图表
2. **防误触规则**：普通聊天、代码编写、文档编辑等非绘图需求，不会触发本技能，避免干扰正常对话。

## 技能工作流

需求解析 → 规范对齐 → 参照范本 → 代码生成 → 自动校验 → 结果输出与渲染

### 步骤 1：需求解析
确认目标图表类型（对照 `references/diagram-types.md` 的 10 类）和核心要素（节点、连线、分组）。

### 步骤 2：规范对齐
读取 `references/diagram-types.md` 确认该类型的布局、连线、标签规范；配色 / 样式需求读取 `references/color-tokens.md`。

### 步骤 3：参照范本
对照 `references/examples.md` 中同类图表的 few-shot 范本，保持风格一致。

### 步骤 4：代码生成
- 优先使用 **Mermaid** 语法生成结构化描述（可编辑、易维护）。
- 若用户要求高质量 SVG 或需精确布局，基于 `references/svg-components.md` 的模板手动构建 SVG XML（深色模式按 `color-tokens.md` 替换变量）。
- 若用户给出 JSON 配置或要求参数化更新，按 `references/json-config.md` 的 schema 解析并渲染。

### 步骤 5：自动校验
若生成了 SVG 文件，调用 `scripts/validate-svg.py` 检查合法性（viewBox 溢出、箭头裁切、长文本、缺 marker 等）；示例如下：
```bash
python scripts/validate-svg.py output.svg
# 或 JSON 详情：python scripts/validate-svg.py output.svg --json
```

### 步骤 6：结果输出与渲染
- **内联预览**：通过 Visualizer 的 `show_widget` 渲染 SVG / HTML 图表，直接内联展示给用户（无需文件）。
- **文件交付**：若生成了 `.svg` 文件，使用 `present_files` 交付并预览；Mermaid 源码以代码块附在说明中，便于用户二次编辑。
- 输出结构：SVG 预览 + Mermaid 源码块 + 简短说明（类型、关键要素、注意事项）。

## Visualizer 渲染硬性约束（内联 SVG 必须遵守）
通过 `show_widget` 内联渲染 SVG 时，除本技能规范外还须满足 Visualizer 设计系统：
- **viewBox 固定宽 680**：`viewBox="0 0 680 H"`，宽度 680 不可改，H = 最底元素 + 20px；根元素 `width="100%"`。
- **安全区**：内容置于 x=40~640、y=40~(H-40) 之间；背景保持透明。
- **扁平设计**：禁用渐变、阴影、模糊、发光、噪点纹理；纯色填充。
- **字号下限 11px**；仅允许 400（常规）与 500（中等）两种字重。
- **描边**：图形边框 0.5px；连线 1.5px；所有作为连线的 `<path>`/`<polyline>` 必须显式 `fill="none"`。
- **文字基线**：框内 `<text>` 必须加 `dominant-baseline="central"`，保证垂直居中。
- **箭头 marker**：使用 Visualizer 标准格式（见 `svg-components.md` §0），`orient="auto-start-reverse"`；open chevron 风格。
- **无旋转文字、无注释节点、每图一个 `<svg>`**。
- **配色**：必须使用 `color-tokens.md` 中「Visualizer 渲染色系」的 9 ramp 色板（路径 A），单图 ≤ 2 个色 ramp。
- **文本溢出**：`<title>`/`<desc>` 作为 `<svg>` 的前两个子元素提供无障碍描述。

## 异常处理指引
- **需求歧义**（如「画个图」未指明类型）：先反问确认图表类型与核心要素，不要猜。
- **超出 10 类的请求**（如思维导图、甘特图）：明确告知当前支持的类型清单，请用户确认最接近的类型或换用其它工具。
- **Mermaid 渲染失败**：回退为手动构建 SVG（按 `svg-components.md` 模板），并在说明中告知用户 Mermaid 语法问题所在。
- **节点过多（>15）**：主动建议拆分子图或仅绘制核心路径，避免生成不可读的大图。
- **校验不通过**：根据 `validate-svg.py` 输出定位问题（溢出/裁切/长文本），修正后重新校验再交付。

## 使用说明

### 示例 1：自然语言出图
> 用户：帮我画一张微服务系统架构图，包含网关、订单服务、用户服务、MySQL 和 Kafka

执行：按「技能工作流」生成系统架构图，内联渲染 SVG，并附 Mermaid 源码。

### 示例 2：基于素材出图
> 用户：（粘贴 SQL 建表语句）根据这些表画一张领域模型图，标出关联关系

执行：解析表结构与外键 → 生成领域模型图 → 校验后交付。

### 示例 3：配置化更新
> 用户：把节点 "订单服务" 改名为 "交易服务"，副本数改成 3

执行：按 `references/json-config.md` 的 schema 维护节点配置，重新渲染，无需从头生成。

### 示例 4：简短需求调用
> 用户：订单状态流转图

执行：识别为状态图类型，直接生成。

## 禁止事项
- ❌ 生成超过 15 个节点的单张大图（须拆分子图或仅绘核心路径）。
- ❌ 内联渲染时使用 Visualizer 9 ramp 色板以外的颜色或超过 2 个色 ramp。
- ❌ 在内联 SVG 中使用渐变、阴影、模糊、发光等非扁平效果。
- ❌ 同一语义（如异步消息）在同一图中使用不同颜色或线型。
- ❌ 交付未经 `scripts/validate-svg.py` 校验的 SVG 文件。
- ❌ 对超出 10 类的绘图请求（如思维导图、甘特图）不告知用户直接生成。
- ❌ 对歧义需求（如「画个图」）不确认类型直接猜测生成。

## 注意事项
- 保持图表简洁，单图节点建议不超过 15 个，复杂系统请拆分子图。
- 配色需符合专业技术文档规范（见 `color-tokens.md`），避免高饱和度刺眼颜色；内联渲染务必用 Visualizer 色板（路径 A）。
- 同一语义（如异步消息）在全图必须保持一致的颜色与线型。
- 所有文本标签需清晰可读，避免重叠；中文标签注意预留宽度（中文每字约等于字号 px 宽）。

使用说明

# 专业绘图制表助手

说句话就能生成专业技术图表，告别拖拽绘图的繁琐操作。

## ✨ 核心亮点
- 🚀 **零学习成本**：不用记任何绘图语法，大白话描述需求就能出图
- 🎨 **风格统一**：所有图表自动对齐专业技术绘图规范，配色清爽、布局清晰
- 📄 **多格式兼容**：同时支持实时预览SVG和可编辑Mermaid代码，适配各类文档场景
- ⚡ **快速迭代**：修改需求描述即可秒级更新图表，调整布局不用重新拖拽

## 📌 支持的图表类型
| 图表类型 | 适用场景 |
| --- | --- |
| 系统架构图 | 展示系统分层、模块划分与组件依赖关系 |
| 调用链路图 | 梳理微服务之间的完整调用流向 |
| 时序图 | 还原接口调用、消息交互的完整时间顺序 |
| 业务流程图 | 梳理业务流程、算法执行的全步骤 |
| 状态图 | 展示订单、资源等对象的全生命周期状态流转 |
| 泳道图 | 清晰呈现跨角色、跨系统的协作流程，支持同步/异步连线区分 |
| 部署架构图 | 绘制服务器、容器、云资源的实际部署拓扑 |
| 数据流图 | 追踪数据从产生、处理到落地的完整流向 |
| 核心原理图 | 拆解技术组件的内部工作运行机制 |
| 领域模型图 | 基于业务实体梳理属性与关联关系 |

## 📖 使用方法

### 自然语言调用（推荐）
直接和Agent描述你的绘图需求，比如「帮我画一个微服务网关的部署架构图」，即可自动触发生成。

**示例：**
```bash
绘制电商微服务架构图
根据上传的order.sql生成电商订单领域模型图
结合项目README生成订单售后全流程时序图
绘制Redis缓存过期策略核心原理图
绘制电商下单-履约-结算全链路泳道图
```

## 🛠️ 高级功能
- **素材驱动**：粘贴 Java/Go 代码或 SQL 文件，Agent 会自动提取类关系或表结构生成图表。
- **样式定制**：可在描述中指定「深色模式」、「扁平化风格」或「AWS官方图标风格」。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。