Skip to content

Agent skill that turns natural language, code, Terraform/K8s, SQL, OpenAPI, AsyncAPI, Protobuf and GraphQL sources into editable, tested draw.io architecture diagrams: incremental sync, multi-view projection, drift diff, CI architecture tests, whiteboard derasterize, interactive HTML/PPTX/Mermaid exports.

docs: document v1.16.0 features in READMEs (seqlayout, compose/SQL importers, --tune) (#55)

Agents365.ai651c367a16ad
diff --git a/README.md b/README.md
index b6f87db..3b5c861 100644
--- a/README.md
+++ b/README.md
@@ -24,7 +24,9 @@ A skill that turns natural-language descriptions into `.drawio` XML and exports
- **6 diagram type presets** — ERD, UML Class, Sequence, Architecture, ML/Deep Learning, Flowchart
- **Visualize a codebase** — extract and auto-lay-out the structure of a Python / JS-TS / Go / Rust project (import graphs) or a Python class hierarchy — Graphviz placement, transitive reduction, nested module containers
-- **IaC → architecture diagram** — turn **Terraform** configs or **Kubernetes** manifests into an architecture diagram where every resource renders as its **official AWS / Azure / GCP / K8s icon**, edges derived from actual references (role ARNs, selectors, volume mounts)
+- **IaC → architecture diagram** — turn **Terraform** configs, **Kubernetes** manifests, or **docker-compose** files into an architecture diagram where every resource renders as its **official AWS / Azure / GCP / K8s icon**, edges derived from actual references (role ARNs, selectors, volume mounts)
+- **SQL DDL → ER diagram** — parse `CREATE TABLE` statements into per-table nodes with PK/FK markers and crow's-foot foreign-key edges
+- **Deterministic sequence diagrams** — describe participants + messages as JSON; lifelines, auto-tracked activation bars, and arrows are computed, never hand-placed
- **Search 10,000+ official shapes** — resolve the exact AWS / Azure / GCP / Cisco / Kubernetes / UML / BPMN icon style instead of guessing (no more blank-box `shape=mxgraph.*` typos)
- **AI / LLM brand logos** — 321 logos (OpenAI, Claude, Gemini, Mistral, Llama, Ollama, LangChain…) that draw.io has none of, for LLM-app architecture diagrams
- **Self-check + auto-fix** — reads its own PNG output and auto-fixes overlaps, clipped labels, stacked edges, and more (up to 2 rounds)
@@ -144,6 +146,11 @@ python3 scripts/pyclasses.py mypackage --group -o graph.json
# Infrastructure as Code — official cloud icons resolved automatically
python3 scripts/tfimports.py ./infra -o graph.json # Terraform → AWS/Azure/GCP icons
python3 scripts/k8simports.py ./manifests -o graph.json # K8s YAML/JSON → kind icons
+python3 scripts/composeimports.py compose.yml -o graph.json # services + named volumes
+
+# Data & interactions
+python3 scripts/sqlerd.py schema.sql -o graph.json # SQL DDL → ER diagram
+python3 scripts/seqlayout.py seq.json -o sequence.drawio # sequence diagram, direct to .drawio
```
<p align="center">
@@ -159,8 +166,9 @@ python3 scripts/autolayout.py graph.json -o diagram.drawio
| Piece | What it does |
|---|---|
-| **7 extractors** | import graphs for **Python · JS/TS · Go · Rust**, **Python class inheritance**, plus **Terraform** and **Kubernetes** resource graphs with official cloud icons |
-| **Auto-layout** | Graphviz places nodes and routes orthogonal edges *around* them — removes the manual-coordinate ceiling for large graphs |
+| **9 extractors** | import graphs for **Python · JS/TS · Go · Rust**, **Python class inheritance**, **Terraform / Kubernetes / docker-compose** resource graphs (official cloud icons), and **SQL DDL → ERD** |
+| **Sequence engine** | `seqlayout.py` computes lifeline / activation-bar / arrow geometry from a message list — no Graphviz, no hand placement |
+| **Auto-layout** | Graphviz places nodes and routes orthogonal edges *around* them — removes the manual-coordinate ceiling for large graphs. `--tune` tries both directions and keeps the more readable one |
| **Transitive reduction** | drops edges implied by a longer path, turning a dense hairball into a traceable graph (asyncio: 149 → 46 edges) |
| **Nested containers** | `--group` boxes modules by sub-package, nested for deep package trees |
| **Deterministic validator** | `validate.py` lints the `.drawio` (dangling edges, duplicate ids, overlaps) before the visual self-check |
@@ -245,7 +253,9 @@ Behind the scenes: **check dependencies → plan layout → generate `.drawio` X
| Iterative review loop | ❌ manual re-prompt | ✅ targeted edits, 5-round safety valve |
| Diagram type presets | ❌ | ✅ 6 presets (ERD, UML, Seq, Arch, ML, Flow) |
| Visualize a codebase | ❌ | ✅ import graphs (Py/JS/Go/Rust) + class diagrams |
-| IaC → architecture diagram | ❌ | ✅ Terraform / K8s manifests → official cloud icons |
+| IaC → architecture diagram | ❌ | ✅ Terraform / K8s / compose → official cloud icons |
+| SQL DDL → ER diagram | ❌ | ✅ `CREATE TABLE` → PK/FK tables, crow's-foot edges |
+| Sequence diagrams | ❌ hand-placed coordinates | ✅ deterministic geometry engine (`seqlayout.py`) |
| Auto-layout for large graphs | ❌ hand-places, overlaps | ✅ Graphviz placement, ortho routing, nested containers |
| Structural validation | ❌ | ✅ deterministic `.drawio` linter |
| Official shape search | ❌ guesses, blank boxes | ✅ exact style for 10k+ AWS/Azure/GCP/UML shapes |
diff --git a/README_CN.md b/README_CN.md
index b52781d..071485c 100644
--- a/README_CN.md
+++ b/README_CN.md
@@ -24,7 +24,9 @@
- **6 种图表类型预设** —— ER 图、UML 类图、序列图、架构图、ML/深度学习、流程图
- **可视化代码库** —— 提取并自动布局一个 Python / JS-TS / Go / Rust 项目的结构(导入关系图)或 Python 类继承层级 —— Graphviz 布点、传递约简、按子包嵌套的容器
-- **IaC → 架构图** —— 把 **Terraform** 配置或 **Kubernetes** manifest 直接变成架构图,每个资源渲染为**官方 AWS / Azure / GCP / K8s 图标**,连线来自真实引用(role ARN、selector、volume 挂载)
+- **IaC → 架构图** —— 把 **Terraform** 配置、**Kubernetes** manifest 或 **docker-compose** 文件直接变成架构图,每个资源渲染为**官方 AWS / Azure / GCP / K8s 图标**,连线来自真实引用(role ARN、selector、volume 挂载)
+- **SQL DDL → ER 图** —— 解析 `CREATE TABLE` 语句,生成带 PK/FK 标记的表节点和鸦爪外键连线
+- **确定性时序图** —— 用 JSON 描述参与者 + 消息序列,lifeline、自动追踪的激活条、箭头几何全部计算得出,无需手摆坐标
- **搜索 10,000+ 个官方形状** —— 直接拿到 AWS / Azure / GCP / Cisco / Kubernetes / UML / BPMN 图标的精确 style,不靠猜(杜绝 `shape=mxgraph.*` 拼错变空白框)
- **AI / LLM 品牌图标** —— 321 个 draw.io 自身没有的 logo(OpenAI、Claude、Gemini、Mistral、Llama、Ollama、LangChain……),专为 LLM 应用架构图准备
- **自检 + 自动修复** —— 读取自己导出的 PNG,自动修复重叠、截断标签、连线堆叠等问题(最多 2 轮)
@@ -142,6 +144,11 @@ python3 scripts/pyclasses.py mypackage --group -o graph.json
# 基础设施即代码 —— 自动解析官方云图标
python3 scripts/tfimports.py ./infra -o graph.json # Terraform → AWS/Azure/GCP 图标
python3 scripts/k8simports.py ./manifests -o graph.json # K8s YAML/JSON → kind 图标
+python3 scripts/composeimports.py compose.yml -o graph.json # 服务 + 命名卷
+
+# 数据与交互
+python3 scripts/sqlerd.py schema.sql -o graph.json # SQL DDL → ER 图
+python3 scripts/seqlayout.py seq.json -o sequence.drawio # 时序图,直接生成 .drawio
```
<p align="center">
@@ -157,8 +164,9 @@ python3 scripts/autolayout.py graph.json -o diagram.drawio
| 组件 | 作用 |
|---|---|
-| **7 个提取器** | **Python · JS/TS · Go · Rust** 的导入关系图、**Python 类继承**,外加 **Terraform** 和 **Kubernetes** 资源图(自动配官方云图标) |
-| **自动布局** | Graphviz 自动布点,正交连线**绕开**节点 —— 大图不再需要手动摆坐标 |
+| **9 个提取器** | **Python · JS/TS · Go · Rust** 的导入关系图、**Python 类继承**、**Terraform / Kubernetes / docker-compose** 资源图(自动配官方云图标),以及 **SQL DDL → ER 图** |
+| **时序图引擎** | `seqlayout.py` 从消息列表直接算出 lifeline / 激活条 / 箭头几何 —— 不需要 Graphviz,不需要手摆 |
+| **自动布局** | Graphviz 自动布点,正交连线**绕开**节点 —— 大图不再需要手动摆坐标。`--tune` 双向各排一次取更可读的 |
| **传递约简** | 删掉被更长路径蕴含的边,把密集的"毛线团"变成可读图(asyncio:149 → 46 条边) |
| **嵌套容器** | `--group` 按子包给模块分框,深层包树自动嵌套 |
| **确定性校验器** | `validate.py` 在视觉自检前先做结构 lint(悬空边、重复 id、重叠) |
@@ -243,7 +251,9 @@ Skill 会提取配色、形状、字体和连线风格,渲染预览图,**确
| 迭代审查循环 | ❌ 需手动重新提问 | ✅ 定向编辑,5 轮安全阀 |
| 图表类型预设 | ❌ | ✅ 6 种(ERD、UML、序列、架构、ML、流程) |
| 可视化代码库 | ❌ | ✅ 导入关系图(Py/JS/Go/Rust)+ 类图 |
-| IaC → 架构图 | ❌ | ✅ Terraform / K8s manifest → 官方云图标 |
+| IaC → 架构图 | ❌ | ✅ Terraform / K8s / compose → 官方云图标 |
+| SQL DDL → ER 图 | ❌ | ✅ `CREATE TABLE` → PK/FK 表节点 + 鸦爪连线 |
+| 时序图 | ❌ 手摆坐标易出错 | ✅ 确定性几何引擎(`seqlayout.py`) |
| 大图自动布局 | ❌ 手动摆放、易重叠 | ✅ Graphviz 布点、正交路由、嵌套容器 |
| 结构校验 | ❌ | ✅ 确定性 `.drawio` linter |
| 官方形状搜索 | ❌ 靠猜、变空白框 | ✅ 1 万+ AWS/Azure/GCP/UML 形状的精确 style |