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(sync): register the AsyncAPI importer everywhere importers are listed

Agents365-aidb968bb15b98
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 0b5e37a..77ccf00 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,7 +5,7 @@ on [Keep a Changelog](https://keepachangelog.com/), and the project follows
semantic-ish versioning (the `metadata.version` field in
`skills/drawio-skill/SKILL.md`).
-## [3.2.4] - 2026-09-11
+## [Unreleased]
### Added
@@ -13,6 +13,8 @@ semantic-ish versioning (the `metadata.version` field in
produce channel, publish/subscribe operation, and payload-schema graphs with
source provenance, direction control, and optional grouping.
+## [3.2.4] - 2026-09-11
+
### Changed
- **README / README_CN reorganized for readability**: the 26 flat Highlights
diff --git a/README.md b/README.md
index 00ab482..a964779 100644
--- a/README.md
+++ b/README.md
@@ -31,7 +31,7 @@ A skill that turns natural language and real system sources into maintainable `.
- **Visualize a codebase** — import graphs for Python / JS-TS / Go / Rust and Python class hierarchies, with Graphviz placement, transitive reduction, and nested module containers
- **IaC and live infrastructure** — Terraform, Kubernetes, and docker-compose configs become diagrams with official AWS / Azure / GCP / K8s icons; snapshot what's *actually deployed* from `terraform show -json`, `docker inspect`, or `kubectl get -o json`
-- **Schemas and pipelines** — SQL DDL → ER diagram, OpenAPI/Swagger → API diagram coloured by HTTP method, GitHub Actions / GitLab CI → pipeline DAG
+- **Schemas and pipelines** — SQL DDL → ER diagram, OpenAPI/Swagger → API diagram coloured by HTTP method, AsyncAPI → event-driven architecture diagram, GitHub Actions / GitLab CI → pipeline DAG
- **Deterministic engines** — sequence diagrams with computed lifelines and activation bars; multi-page C4 models with click-to-drill-down
**Keep it true over time**
@@ -200,7 +200,7 @@ The full toolbox, grouped by stage:
| Stage | Tools |
| --- | --- |
-| **Import** | 13 extractors: **Python · JS/TS · Go · Rust** import graphs, **Python class inheritance**, **Terraform / Kubernetes / docker-compose** with official cloud icons, **live** infra from `terraform show -json` / `docker inspect` / `kubectl get -o json`, **SQL DDL → ERD**, **OpenAPI → API diagram** (coloured by HTTP method), **GitHub Actions + GitLab CI → DAG** |
+| **Import** | 14 extractors: **Python · JS/TS · Go · Rust** import graphs, **Python class inheritance**, **Terraform / Kubernetes / docker-compose** with official cloud icons, **live** infra from `terraform show -json` / `docker inspect` / `kubectl get -o json`, **SQL DDL → ERD**, **OpenAPI → API diagram** (coloured by HTTP method), **AsyncAPI → event-driven architecture diagram**, **GitHub Actions + GitLab CI → DAG** |
| **Compare & evolve** | `drawiodiff.py` colour-codes drift between two diagrams or two live snapshots (added=green, removed=red, changed=orange); `timelapse.py` replays git history as an HTML player; `prdiff.py` renders PR diffs in CI |
| **Repurpose** | `explain.py` → Markdown, `drawiohtml.py` → pan/zoom/search HTML viewer, `drawio2pptx.py` → deck, `svgflow.py` → animated SVG, `drawio2mermaid.py` → diagrams-as-code, `runbook.py` → clickable triage app, `compress.py` → exec summary with drill-down, `buildup.py` → self-drawing player, `tubemap.py` → metro map |
| **Restyle & enrich** | `restyle.py` applies presets by hue remap, `relabel.py` produces translated twins with layout untouched, `heatmap.py` shades nodes from a metrics CSV/JSON, `edgeports.py` un-stacks edges at shape boundaries |
@@ -302,7 +302,7 @@ Behind the scenes: **check dependencies → plan layout → generate `.drawio` X
| **Browser fallback** | ✅ diagrams.net URL (viewer + editable) | ✅ diagrams.net URL (plugin) + inline preview | ✅ via optional MCP | ✅ diagrams.net viewer (primary) |
| **Zero-config** | ✅ copy `skills/drawio-skill/` | ✅ | ✅ desktop-only mode | ❌ needs plugin install |
-> **Using the official jgraph plugin?** [jgraph/drawio-mcp](https://github.com/jgraph/drawio-mcp) now ships an official Claude Code plugin (`/plugin install drawio@drawio`) that also generates `.drawio` and exports via the desktop CLI. drawio-skill is complementary — reach for it when you want the code / IaC / SQL / OpenAPI importers, AI-brand logos, deterministic sequence & C4 generators, self-check + review loop, and the interactive HTML viewer, all from a single SKILL.md with no MCP server.
+> **Using the official jgraph plugin?** [jgraph/drawio-mcp](https://github.com/jgraph/drawio-mcp) now ships an official Claude Code plugin (`/plugin install drawio@drawio`) that also generates `.drawio` and exports via the desktop CLI. drawio-skill is complementary — reach for it when you want the code / IaC / SQL / OpenAPI / AsyncAPI importers, AI-brand logos, deterministic sequence & C4 generators, self-check + review loop, and the interactive HTML viewer, all from a single SKILL.md with no MCP server.
Full comparison + key-advantages summary in [docs/COMPARISON.md](docs/COMPARISON.md) (with audit timestamp).
diff --git a/README_CN.md b/README_CN.md
index 8f45615..2378ea3 100644
--- a/README_CN.md
+++ b/README_CN.md
@@ -31,7 +31,7 @@
- **可视化代码库** —— Python / JS-TS / Go / Rust 项目的导入关系图与 Python 类继承层级,Graphviz 布点、传递约简、按子包嵌套的容器
- **IaC 与实时基础设施** —— Terraform、Kubernetes、docker-compose 配置直接变成带**官方 AWS / Azure / GCP / K8s 图标**的架构图;也能从 `terraform show -json`、`docker inspect`、`kubectl get -o json` 画出**真正在运行**的东西
-- **Schema 与流水线** —— SQL DDL → ER 图,OpenAPI/Swagger → 按 HTTP 方法着色的 API 图,GitHub Actions / GitLab CI → 流水线 DAG
+- **Schema 与流水线** —— SQL DDL → ER 图,OpenAPI/Swagger → 按 HTTP 方法着色的 API 图,AsyncAPI → 事件驱动架构图,GitHub Actions / GitLab CI → 流水线 DAG
- **确定性引擎** —— 序列图自动计算 lifeline 与激活条;多页 C4 模型支持点击下钻
**让图长期保持真实**
@@ -197,7 +197,7 @@ python3 scripts/drawiohtml.py architecture.drawio -o architecture.html
| 阶段 | 工具 |
| --- | --- |
-| **导入** | 13 个提取器:**Python · JS/TS · Go / Rust** 导入关系图、**Python 类继承**、**Terraform / Kubernetes / docker-compose**(官方云图标)、从 `terraform show -json` / `docker inspect` / `kubectl get -o json` 提取的**实时**基础设施、**SQL DDL → ER 图**、**OpenAPI → API 图**(按 HTTP 方法着色)、**GitHub Actions + GitLab CI → DAG** |
+| **导入** | 14 个提取器:**Python · JS/TS · Go / Rust** 导入关系图、**Python 类继承**、**Terraform / Kubernetes / docker-compose**(官方云图标)、从 `terraform show -json` / `docker inspect` / `kubectl get -o json` 提取的**实时**基础设施、**SQL DDL → ER 图**、**OpenAPI → API 图**(按 HTTP 方法着色)、**AsyncAPI → 事件驱动架构图**、**GitHub Actions + GitLab CI → DAG** |
| **对比与演进** | `drawiodiff.py` 用颜色标出两张图或两个实时快照的漂移(新增=绿、删除=红、变更=橙);`timelapse.py` 把 git 历史重放成 HTML 播放器;`prdiff.py` 在 CI 里渲染 PR diff |
| **二次利用** | `explain.py` → Markdown,`drawiohtml.py` → 平移缩放搜索的 HTML 查看器,`drawio2pptx.py` → 演示稿,`svgflow.py` → 动画 SVG,`drawio2mermaid.py` → diagrams-as-code,`runbook.py` → 点击式排查应用,`compress.py` → 可下钻的高管摘要,`buildup.py` → 自动绘制播放器,`tubemap.py` → 地铁图 |
| **换肤与增强** | `restyle.py` 按色相重映射应用预设,`relabel.py` 布局不动地生成翻译变体,`heatmap.py` 按指标 CSV/JSON 给节点上色,`edgeports.py` 解开形状边界上堆叠的连线 |
@@ -299,7 +299,7 @@ Skill 会提取配色、形状、字体和连线风格,渲染预览图,**确
| **浏览器降级** | ✅ diagrams.net URL(查看 + 可编辑) | ✅ diagrams.net URL(插件)+ 内联预览 | ✅ 通过可选 MCP | ✅ diagrams.net viewer(主要) |
| **零配置** | ✅ 复制 `skills/drawio-skill/` | ✅ | ✅ 桌面版模式 | ❌ 需安装插件 |
-> **在用官方 jgraph 插件?** [jgraph/drawio-mcp](https://github.com/jgraph/drawio-mcp) 现已提供官方 Claude Code 插件(`/plugin install drawio@drawio`),同样生成 `.drawio` 并通过桌面版 CLI 导出。drawio-skill 与之互补 —— 当你需要代码 / IaC / SQL / OpenAPI 导入器、AI 品牌图标、确定性时序图与 C4 生成器、自检 + 审查循环以及交互式 HTML 查看器,且只想用单个 SKILL.md、无需 MCP 服务时,选它。
+> **在用官方 jgraph 插件?** [jgraph/drawio-mcp](https://github.com/jgraph/drawio-mcp) 现已提供官方 Claude Code 插件(`/plugin install drawio@drawio`),同样生成 `.drawio` 并通过桌面版 CLI 导出。drawio-skill 与之互补 —— 当你需要代码 / IaC / SQL / OpenAPI / AsyncAPI 导入器、AI 品牌图标、确定性时序图与 C4 生成器、自检 + 审查循环以及交互式 HTML 查看器,且只想用单个 SKILL.md、无需 MCP 服务时,选它。
完整对比 + 核心优势总结见 [docs/COMPARISON_CN.md](docs/COMPARISON_CN.md)(含核查时间戳)。
diff --git a/skills/drawio-skill/references/diagram-ir.md b/skills/drawio-skill/references/diagram-ir.md
index b9e0ba2..93a533b 100644
--- a/skills/drawio-skill/references/diagram-ir.md
+++ b/skills/drawio-skill/references/diagram-ir.md
@@ -55,9 +55,9 @@ python3 scripts/diagramctl.py inspect architecture.drawio
python3 scripts/diagramctl.py query architecture.drawio --from internet --to orders-db
```
-`build --from auto` recognizes Diagram IR/graph JSON, SQL, OpenAPI, compose,
-Kubernetes YAML, and common repository markers. Use an explicit `--from` when
-the source is ambiguous.
+`build --from auto` recognizes Diagram IR/graph JSON, SQL, OpenAPI, AsyncAPI,
+compose, Kubernetes YAML, and common repository markers. Use an explicit `--from`
+when the source is ambiguous.
## Reconcile instead of regenerate
diff --git a/skills/drawio-skill/references/mcp.md b/skills/drawio-skill/references/mcp.md
index 1e7f68d..a4af526 100644
--- a/skills/drawio-skill/references/mcp.md
+++ b/skills/drawio-skill/references/mcp.md
@@ -30,7 +30,7 @@ call shells out to `scripts/diagramctl.py`, the same CLI the skill uses.
| Tool | Maps to | Purpose |
| --- | --- | --- |
| `doctor` | `diagramctl doctor` | Check python/draw.io/Graphviz availability without launching anything |
-| `build` | `build` | Code / IaC / SQL / OpenAPI / graph / IR → editable `.drawio` (+ optional IR) |
+| `build` | `build` | Code / IaC / SQL / OpenAPI / AsyncAPI / graph / IR → editable `.drawio` (+ optional IR) |
| `sync` | `sync` | Incremental re-sync of a diagram from its changed source, preserving manual layout |
| `views` | `views` | Project an IR file into linked executive/system/deployment/dataflow/security pages |
| `architecture_test` | `test` | Deterministic architecture contract rules (policy YAML/JSON); `isError` mirrors the CI exit code |
diff --git a/skills/drawio-skill/references/toolbox.md b/skills/drawio-skill/references/toolbox.md
index cbcbe52..cd83f5a 100644
--- a/skills/drawio-skill/references/toolbox.md
+++ b/skills/drawio-skill/references/toolbox.md
@@ -1,6 +1,6 @@
# Toolbox — every bundled script, by use-case
-A map of the 40 focused tools, the unified `diagramctl.py` orchestrator
+A map of the 41 focused tools, the unified `diagramctl.py` orchestrator
(and its MCP server wrapper), and its
internal `diagram_ir.py` model grouped by what you're trying to do. The
per-task routing table in `SKILL.md` says *when* to reach for each; this says
diff --git a/skills/drawio-skill/scripts/diagramctl_mcp.py b/skills/drawio-skill/scripts/diagramctl_mcp.py
index 0787dfd..0d44d2e 100644
--- a/skills/drawio-skill/scripts/diagramctl_mcp.py
+++ b/skills/drawio-skill/scripts/diagramctl_mcp.py
@@ -54,7 +54,8 @@ TOOLS = [
"name": "build",
"description": (
"Build an editable .drawio diagram from code, IaC, SQL, OpenAPI, "
- "compose, a graph JSON, or an existing IR file. Auto-detects the "
+ "AsyncAPI, compose, a graph JSON, or an existing IR file. "
+ "Auto-detects the "
"source type. Returns a JSON report and writes the .drawio (and "
"optionally the IR JSON)."
),
@@ -66,7 +67,7 @@ TOOLS = [
"type": "string",
"description": "Override auto-detection "
"(python|javascript|go|rust|pyclasses|terraform|kubernetes|"
- "compose|sql|openapi|ci|graph|ir|drawio)",
+ "compose|sql|openapi|asyncapi|ci|graph|ir|drawio)",
},
"group": {
"type": "boolean",