Przejdź do treści
Biblioteka skilli
Projektowanie i UX · Budowanie i kod

simplechart

/simplechart

Rysuje diagramy PNG: procesy, mapy myśli, sekwencje, ER i architekturę, a przed oddaniem sprawdza geometrię i piksele.

Repozytorium
SimpleChart ↗
Licencja
MIT
Ostatnia zmiana repozytorium
05.11.2026

Ocena i bezpieczeństwo

95/ 100Klasa: dobry
Format20 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
7
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 05.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Rysuje diagramy PNG: procesy, mapy myśli, sekwencje, ER i architekturę, a przed oddaniem sprawdza geometrię i piksele.

Wyzwalacze z opisu

画个流程图整理成思维导图画个时序图画个 ER 图表结构怎么设计画个架构图系统分几层谁先谁后
Oryginalny opis (EN)

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

Jak działa

  1. 0. 用 / 不用,以及先定类型
  2. 1. 五条硬规则
  3. 2. 开工前先确认(缺就一次问清,别猜)
  4. 3. 工作流程
  5. 4. spec.json(唯一输入)
  6. 5. 默认排版(不用你调,知道就行)
  7. 6. 自检清单
  8. 7. 常见问题 → 怎么修
  9. 8. 产物约定
  10. 9. 已有示例
Sekcje z nagłówków SKILL.md, w oryginale · 193 linii, 813 słów
Podgląd SKILL.md
---
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`,改成自己的内容,重渲染。
Pliki w paczce (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

Wersje

W bazie nie ma innych skilli o nazwie simplechart.

Migawka bazy z 13.11.2026 · wersja paczki 491d334d3d91 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100flow-diagram
    Tworzy, sprawdza i eksportuje diagramy FlowSVG: schematy przepływu, architektury i sekwencje, także animowane, w JSON, HTML, SVG, PNG lub GIF.
  • 100mermaid
    Tworzy diagramy jako tekst w Mermaid: przepływy, sekwencje, Gantta, ER, klas, mapy myśli i stany, do wklejenia w Markdown, Notion lub GitHub.
  • 100diagram
    Generuje profesjonalne diagramy PNG, HTML lub DSL Mermaid, dobierając typ spośród 29 (przepływy, architektura, sekwencje, ER, Gantt oraz wykresy statystyczne) według jednolitych zasad projektowych.
  • 95fireworks-tech-graph
    Tworzy diagramy techniczne: architektury, przepływy danych, sekwencje i mapy pojęć, eksportując je jako SVG i PNG.
  • 100fireworks-tech-graph
    Renderuje opisane tekstem struktury techniczne jako diagramy SVG i PNG w 14 typach, od architektury i sekwencji po ER i topologię sieci, w 7 stylach wizualnych.
  • 100mermaid-diagrams
    Pisze diagramy tekstowo w Mermaid: przepływy, sekwencje, ER, Gantta i inne, by były czytelne w READMe, PR-ach i dokumentach.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.