Skip to content
Skills Library
Design & UX · Building & coding

simplechart

/simplechart

把流程、层级、交互顺序、数据关系或系统组成画成一张 PNG 图(流程图 / 思维导图 / 时序图 / ER 图 / 架构图)。先量字再定框、连线走正交端口、白底黑字加语义浅色,出图后自动跑几何与像素自检,自检不通过不算完成。用户说"画个流程图""整理成思维导图""画个时序图""画个 ER 图""表结构怎么设计""画个架构图""系统分几层""谁先谁后""mind map""flowchart""sequence diagram""ER diagram""architecture diagram"时使用。不画 UML 类图、甘特图、部署图、C4 全景图。

Author
L-XUN ↗
Repository
SimpleChart ↗
Licence
MIT
Last repository change
05.11.2026

Assessment and security

95/ 100Class: good
Format20 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
7
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 05.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

把流程、层级、交互顺序、数据关系或系统组成画成一张 PNG 图(流程图 / 思维导图 / 时序图 / ER 图 / 架构图)。先量字再定框、连线走正交端口、白底黑字加语义浅色,出图后自动跑几何与像素自检,自检不通过不算完成。用户说"画个流程图""整理成思维导图""画个时序图""画个 ER 图""表结构怎么设计""画个架构图""系统分几层""谁先谁后""mind map""flowchart""sequence diagram""ER diagram""architecture diagram"时使用。不画 UML 类图、甘特图、部署图、C4 全景图。

Triggers from the description

画个流程图整理成思维导图画个时序图画个 ER 图表结构怎么设计画个架构图系统分几层谁先谁后
Original author description

把流程、层级、交互顺序、数据关系或系统组成画成一张 PNG 图(流程图 / 思维导图 / 时序图 / ER 图 / 架构图)。先量字再定框、连线走正交端口、白底黑字加语义浅色,出图后自动跑几何与像素自检,自检不通过不算完成。用户说"画个流程图""整理成思维导图""画个时序图""画个 ER 图""表结构怎么设计""画个架构图""系统分几层""谁先谁后""mind map""flowchart""sequence diagram""ER diagram""architecture diagram"时使用。不画 UML 类图、甘特图、部署图、C4 全景图。

How it works

  1. 0. 用 / 不用,以及先定类型
  2. 1. 五条硬规则
  3. 2. 开工前先确认(缺就一次问清,别猜)
  4. 3. 工作流程
  5. 4. spec.json(唯一输入)
  6. 5. 默认排版(不用你调,知道就行)
  7. 6. 自检清单
  8. 7. 常见问题 → 怎么修
  9. 8. 产物约定
  10. 9. 已有示例
Original SKILL.md headings · 193 lines, 813 words
SKILL.md preview
---
name: simplechart
description: 把流程、层级、交互顺序、数据关系或系统组成画成一张 PNG 图(流程图 / 思维导图 / 时序图 / ER 图 / 架构图)。先量字再定框、连线走正交端口、白底黑字加语义浅色,出图后自动跑几何与像素自检,自检不通过不算完成。用户说"画个流程图""整理成思维导图""画个时序图""画个 ER 图""表结构怎么设计""画个架构图""系统分几层""谁先谁后""mind map""flowchart""sequence diagram""ER diagram""architecture diagram"时使用。不画 UML 类图、甘特图、部署图、C4 全景图。
whenToUse: 需要把审批链、判断分支、步骤流程、层级结构、交互时序、数据库表关系或系统分层输出成一张能直接贴进文档 / PPT 的 PNG 时。
metadata:
  version: 1.3.0
  renderer: svg + sharp
  font: SimHei (fallback Microsoft YaHei / Noto Sans SC)
  types: flowchart / mindmap / sequence / er / arch
---

# simplechart

一句话:**写一份 `spec.json`,用同目录 `scripts/` 里的渲染器出 PNG,自检 PASS 才算画完。**

不要把"怎么画"现场再发明一遍——渲染器已经在这里了。你的工作是**把结构想清楚、把字写好**,不是拼 SVG。

## 0. 用 / 不用,以及**先定类型**

用:审批流、操作步骤、判断分支、故障处理流程、组织结构、知识点拆解、会议决策树、**消息传递与机制时序**、**数据库表关系**、**系统分层与模块组成**。
不用:UML 类图、甘特图、部署图(IP/端口/容器)、C4 全景图——这些硬套本 skill 的符号会画歪。用户要这些时说明一下,别硬画。

### 填 spec 之前,先按下表定 `type`(这一步不要跳)

| 用户说的 | `type` | 接下来必读 |
|---|---|---|
| 流程、审批、步骤、判断走哪一步、故障怎么处理 | `flowchart` | 本文档 §4 + §5,够用 |
| 整理成思维导图、脑图、拆解层级、知识点结构 | `mindmap` | 本文档 §4「思维导图字段」,够用 |
| 谁先谁后、谁调用谁、消息怎么传、机制通路 | `sequence` | **`references/sequence.md`** |
| 数据库设计、表结构、实体关系、一对多/多对多、字段与主键 | `er` | **`references/er.md`** |
| 系统分几层、由哪些模块组成、模块之间怎么依赖 | `arch` | **`references/arch.md`** |
| 判断不出来 | — | **先问用户一句**,别猜着画 |

**read reference 是硬要求,不是建议**:`sequence` 是 `actors` + `messages`,`er` 是 `entities` + `relations`,`arch` 是 `layers` + `links`,都不是 `nodes` + `edges`。没读就写,`render.mjs` 会直接报字段缺失;这不是提醒,是跑不通。

## 1. 五条硬规则

1. **先量文字,再定框。** 已由渲染器保证;不要手写 `w` / `h` 去压框,压小了自检会 FAIL。
2. **连线只能贴在框边,其余部分不得与任何框相交**(净距 ≥ 4px)。穿框 = 自检 FAIL。
3. **判断(菱形)必须有 ≥ 2 个出口,每条出口必须标条件**(是 / 否 / 具体条件)。
4. **一图一个开始;开始无入边、结束无出边;除结束外每个节点都要有出边。**
5. **出图后必须跑自检**;FAIL 就改 spec 重跑,**不许手改 PNG / SVG 去糊**。

> 第 2~4 条只针对流程图;时序图、ER 图、架构图的对应规则在各自的 reference 里。


## 2. 开工前先确认(缺就一次问清,别猜)

- 图类型:流程图 / 思维导图
- 节点粒度:一句话一个框?还是几个框?
- 用词:沿用用户原话("直属主管"不要改写成"直线经理")
- 用途:贴文档 / 上 PPT / 打印 → 决定 `--scale`(文档 1x、PPT 与打印 2x)
- 数据来源:用户给的,还是需要检索?**检索来的内容要能说出来源;查不到就写 `[待确认]`,绝不编造数字**

## 3. 工作流程

1. **定类型**:按 §0 的表定 `type`;是 `sequence` 就先读完 `references/sequence.md` 再动手。
2. **理结构**:先想清楚节点与边(或参与者与消息),再落 `spec.json`(格式见第 4 节)。
3. **排网格**:流程图给每个节点一个 `row`(行,从上到下)、`col`(列,从左到右)。主干走 `col: 0`,分支往右放到 `col: 1`。**别让两个节点抢同一个格子。**
4. **出图 + 自检**(脚本在 skill 目录的 `scripts/`,下面路径里的 `<skill>` 换成加载时给出的目录):

   ```powershell
   node "<skill>/scripts/render.mjs" spec.json out.png            # 1x
   node "<skill>/scripts/render.mjs" spec.json out.png --scale 2  # 2x(PPT/打印)
   node "<skill>/scripts/check.mjs" spec.json out.png             # 只查不画
   ```

5. **看图复核**:用 `read_image` 打开产物,看四件事——① 汉字有没有变豆腐块 ② 有没有字贴框线 ③ 有没有线穿框 / 线交叉 ④ 阅读顺序是不是从上到下、从左到右。
6. **交付**:贴图 + 说明产物路径 + 报自检结论;有 `[注意]` 项就直说,不要隐瞒。

## 4. spec.json(唯一输入)

最小可用:

```json
{
  "type": "flowchart",
  "title": "请假审批流程",
  "nodes": [
    { "id": "s",  "shape": "start",    "text": "提交申请",     "row": 0, "col": 0 },
    { "id": "p1", "shape": "process",  "text": "直属主管审批", "row": 1, "col": 0 },
    { "id": "d1", "shape": "decision", "text": "≤ 3 天?",     "row": 2, "col": 0 },
    { "id": "e1", "shape": "end",      "text": "人事备案",     "row": 3, "col": 0 },
    { "id": "e2", "shape": "end",      "text": "驳回",         "row": 3, "col": 1 }
  ],
  "edges": [
    { "from": "s",  "to": "p1" },
    { "from": "p1", "to": "d1" },
    { "from": "d1", "to": "e1", "label": "是" },
    { "from": "d1", "to": "e2", "label": "否" }
  ]
}
```

这段是**语法样本**,不是示例成品:照它抄就不会写错字段。它本身能通过自检(判断双出口、两个结束),可以直接丢给 `render.mjs` 试。

### 流程图字段

| 字段 | 说明 |
|---|---|
| `shape` | `start` 胶囊起 / `end` 胶囊止 / `process` 矩形 / `decision` 菱形 / `io` 平行四边形 / `subprocess` 圆角矩形。也认中文:开始、结束、判断、输入输出、子流程 |
| `text` | 标签。**一个框最多 4 行**;超过就拆节点,别缩字号 |
| `row` / `col` | 网格坐标,整数。不写则 row=序号、col=0 |
| `textWidth` | 可选,换行宽度(默认:普通框 190、判断 118、输入输出 150) |
| `w` / `h` | 可选,强制尺寸。**一般不要用**,用了就要保证装得下字 |
| `edges[].label` | 出口条件。判断节点的每条出边必填,其他边建议不填 |

注意:判断的两个出口要落到不同 `col`,否则两条线会叠在一起。

### 思维导图字段

```json
{
  "type": "mindmap",
  "title": "刷 B 站的取舍",
  "root": { "text": "刷 B 站" },
  "branches": [
    { "text": "时间预算", "children": ["午休 20 分钟", "睡前 15 分钟"] },
    { "text": "内容偏好", "children": ["技术 / 硬件", "剪辑与运镜"] }
  ]
}
```

规则:中心 1 个;主分支 ≥ 2 且**左右交替排**(第 1、3、5 条在右,第 2、4、6 条在左);深度 ≤ 4 层;节点只用矩形;连线不带箭头;每条主分支一套颜色,子层继承。

### 时序图字段

**不在本文档里,去读 `references/sequence.md`。** 它的结构是 `actors` + `messages`,与 `nodes` + `edges` 完全不同;没读就写,渲染器会直接报字段缺失。

### ER 图字段

**不在本文档里,去读 `references/er.md`。** 它的结构是 `entities` + `relations`,字段列表内嵌在实体里。没读就写,渲染器会直接报字段缺失。

### 架构图字段

**不在本文档里,去读 `references/arch.md`。** 它的结构是 `layers` + `links`,模块必须落在层里。没读就写,渲染器会直接报字段缺失。

### 主题(可选)

`"theme": { "bg": "#FFFFFF", "stroke": "#1F2328", "palette": { "process": "#FFFFFF" } }`。
默认值已够用,**不要为了好看加渐变、阴影、3D、装饰图标**。

## 5. 默认排版(不用你调,知道就行)

- 字号 16,行高 1.45,标题 20;框内留白 14×10;行距 56、列距 68;画布外边距 40
- 框线 2px、连线 2px、箭头 9px,全部同色同粗
- 白底、深灰黑字(`#1F2328`)、按语义浅色填充;文字与填充对比度 ≥ 4.5:1
- 连线自动选口:朝空隙大的那条轴出,同侧多条线自动错开;走不通就绕外侧或列间通道
- 拐点默认 ≤ 2 个;回头线走图外侧,不横穿中间
- 时序图:列距 112、参与者框统一高度、消息行距 26、生命线虚线
- ER 图:实体列距 124、行距 78、字段行高 26、基数标签贴两端、关系动词放线的另一侧
- 架构图:层内模块间距 56、层间间距 24、层容器浅底 + 层名、模块可带一行小号技术栈

## 6. 自检清单

脚本查(`check.mjs`):标签非空、起止与分支齐备、判断出口与条件、无孤立/断头节点、框不重叠、线不穿框、端点落在框边、文字按各自形状几何内切不溢出、文字真的落到了像素上、对比度、画布尺寸。
时序图查的是另一套:参与者 ≥ 2、每条消息有标签、重复消息、标签不越界、标签不压参与者框(详见 `references/sequence.md`)。
ER 图查的也是另一套:实体有字段、字段有名字、缺主键(WARN)、字段过多(WARN)、关系动词(WARN)、同一对实体多条关系(WARN)、基数标签不压实体(详见 `references/er.md`)。
架构图:每层有模块、模块必须在自己层内、模块不能连自己、重复连接(WARN)、缺标签(WARN)、单层模块过多(WARN)、**连线不能和模块边框重合**、标签不压模块(详见 `references/arch.md`)。

人眼查(`read_image`):字体是否真的渲染、是否有视觉拥挤、阅读顺序是否顺畅、语义是否和用户说的一致。

**任何一项 FAIL:改 spec 重跑。** 不要用"调一下 JSON 里的 w/h"来掩盖文字放不下的事实——那是该拆节点。

## 7. 常见问题 → 怎么修

| 现象 | 修法 |
|---|---|
| `文字必须完整在框内` FAIL | 删掉手写的 `w`/`h`;或把长标签拆成两个框 |
| `连线不得穿过线框` FAIL | 调 `row`/`col`,把挡路的节点挪开一列;或让目标换一行 |
| `判断的出口必须标条件` FAIL | 给该边补 `"label": "是"` / `"否"` |
| 两条线叠在一起 | 两个出口放到不同 `col`;同侧多线本来会自动错开 |
| 一个字被挤到下一行 | 缩短标签,或调小该节点的 `textWidth` 换个断行点 |
| 图太大放不进一页 | 拆成两张图(主流程 + 子流程展开),别缩字号 |
| 报错 `sequence 需要 actors 数组` | 你在画时序图但写了 `nodes`,去读 `references/sequence.md` |
| 报错 `er 需要 entities 数组` | 你在画 ER 但写了 `nodes`,去读 `references/er.md` |
| `关系必须标两端基数` FAIL | 把 `N` 改成 `1:N`(两端都要) |
| ER 关系线穿过别的实体 | 调 `row`/`col` 挪开挡路的实体;ER 对排布比流程图敏感 |
| 报错 `arch 需要 layers 数组` | 你在画架构图但写了 `nodes`,去读 `references/arch.md` |
| `模块必须落在所在层内` FAIL | 删掉模块上多余的手写定位字段,位置由层自动排 |
| 架构图连线穿过别的模块 | 把目标模块挪到同层另一侧;跨层链路超过 3 条就拆图 |
| 报错 `不支持的 type` | 拼写错了;可用 `flowchart` / `mindmap` / `sequence`,也认中文名 |
| 报错 `没找到 sharp` | 先照常出 SVG(会留在旁边),再按提示用无头 Edge 截图 |

## 8. 产物约定

- 图:`<任务名>.png`(需要 2x 时另存 `-2x.png`)
- 结构:`spec.json`(**必须留**,改图只改它再重渲染,幂等)
- 中间件:`.svg`(调试用,交付时不用给)
- 落盘位置:用户指定优先;没指定就放当前工作目录,**文件名带主题,不要覆盖同名文件**(重名加 `-2`)
- 交付时用 `present` 把 PNG 给出去,并说明 spec.json 的位置

## 9. 已有示例

- `examples/approval-flow/` —— 8 节点审批流(含退回回边、判断双出口)
- `examples/team-mindmap/` —— 15 节点思维导图(左右平衡 + 分支配色)
- `examples/stress-20/` —— 20 节点压力用例(长标签、三条回边),验证排版上限
- `examples/iprgc-sequence/` —— 时序图(蓝光 → ipRGC → SCN → 松果体,含自调用与反馈虚线)
- `examples/shop-er/` —— ER 图(用户 / 订单 / 明细 / SKU / 地址,1:N 关系与基数标注)
- `examples/service-arch/` —— 架构图(4 层 / 9 模块 / 8 条依赖,含跨层链路)

改图最快的路径:复制一个示例的 `spec.json`,改成自己的内容,重渲染。
Files in this package (7)
  • .gitattributes 1 KB
  • .gitignore 1 KB
  • CHANGELOG.md 2 KB
  • LICENSE 1 KB
  • README.md 6 KB
  • SKILL.md 13 KB
  • package.json 1 KB

Versions

The database has no other skills named simplechart.

Database snapshot: 13.11.2026 · package version 491d334d3d91 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100flow-diagram
    Use when the user asks to create or revise a flowchart, architecture diagram, sequence diagram, or animated process explanation(流程图、架构图、时序图、流程动画演示). Create executable FlowSVG diagrams with static views or animation; validate or diagnose existing diagrams; export JSON, offline…
  • 100mermaid
    Create diagrams as text using Mermaid syntax: flowcharts, sequence diagrams, gantt charts, ER diagrams, class diagrams, mindmaps, and state diagrams. Use when users want to visualize a process, architecture, timeline, data model, or flow, or ask for a diagram/chart/flowchart…
  • 100diagram
    专业图表生成技能:根据需求自动选择合适的图表类型,生成符合设计规范的 PNG 图表。 覆盖 29 种图表:结构图(流程图、泳道图、时序图、架构图、状态图、ER图、类图、思维导图、甘特图、Kanban、Git Graph 等) 和统计图(柱状图、折线图、饼图、雷达图、热力图、散点图、桑基图、漏斗图、瀑布图、矩形树图、柱线混合图等)。 统一工具:HTML/SVG + 内联 JS 布局计算。ER/类图使用 ELKjs 布局引擎。 所有图表遵循统一的设计规范(配色/字体/组件/间距),风格现代简洁。…
  • 95fireworks-tech-graph
    Use when the user wants to create any technical diagram - architecture, data flow, flowchart, sequence, agent/memory, or concept map - and export as SVG+PNG. Trigger on: "画图" "帮我画" "生成图" "做个图" "架构图" "流程图" "可视化一下" "出图" "generate diagram" "draw diagram" "visualize" or any…
  • 100fireworks-tech-graph
    生产级技术图绘制官,把文字描述的技术结构渲染成可交付的 SVG 与 PNG 图件,覆盖架构图、数据流图、流程图、序列图、Agent 架构图、记忆架构图、思维导图、类图、用例图、状态机图、ER 图、网络拓扑图、对比矩阵与时间线共 14 类图型,内置 UML 14 类覆盖映射、形状词汇表、箭头语义系统、正交路由、标签背景防遮挡、8px 网格对齐、7 套视觉风格(Flat Icon / Dark Terminal / Blueprint / Notion Clean / Glassmorphism / Claude Official / OpenAI…
  • 100mermaid-diagrams
    Write diagrams as text with Mermaid — flowchart, sequence, state, ER, class, gantt, gitGraph, mindmap, timeline, quadrant, sankey, xychart and friends — so structure stays legible in READMEs, PRs, design docs and slides, and stays reviewable in version control. Use when a…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.