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.
Python agent-skillsarchitecturearchitecture-diagramasyncapibpmnc4-modelclaude-codediagramdiagrams-as-codedrawioflowchartgithub-actionsgraphqlimage-to-diagramkubernetesmcp-serverprotobufsysmlterraformuml
docs: document v1.16.0 features in READMEs (seqlayout, compose/SQL importers, --tune) (#55)
Agents365.ai651c367a16ad
diff --git a/README.md b/README.mdindex 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 automaticallypython3 scripts/tfimports.py ./infra -o graph.json # Terraform → AWS/Azure/GCP iconspython3 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.mdindex 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 |