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: swap README to English as default GitHub display
Agents365-ai7583e0c66198
diff --git a/README.md b/README.mdindex 1d1c96d..42254ae 100644--- a/README.md+++ b/README.md@@ -1,150 +1,150 @@# drawio-skill-[English](README_EN.md)+[中文文档](README_CN.md)-## 功能说明+## What it does-- 根据自然语言描述生成 `.drawio` XML 文件-- 使用 draw.io 桌面版原生 CLI 将图表导出为 PNG、SVG、PDF 或 JPG-- 支持多页图表和分层分组-- 迭代设计:预览、获取反馈、反复优化直到图表满意为止-- 当图表有助于解释复杂系统时自动触发+- Generates `.drawio` XML files from natural language descriptions+- Exports diagrams to PNG, SVG, PDF, or JPG using the native draw.io desktop CLI+- Supports multi-page diagrams and layered grouping+- Iterative design: preview, get feedback, and refine diagrams until they look right+- Triggers automatically when diagrams would help explain complex systems-## 对比+## Comparison-### 与原生 Claude Code(无 skill)对比+### vs Native Claude Code (no skill)-| 功能 | 原生 Claude Code | 本 skill |-|------|-----------------|---------|-| 生成 draw.io XML | 是 — Claude 本身了解格式 | 是 |-| 导出后自检 | 否 | 是 — 读取 PNG 自动修复 6 类问题 |-| 迭代反馈循环 | 否 — 需手动重新提问 | 是 — 定向编辑,5 轮安全阀 |-| 主动触发 | 否 — 仅在明确要求时 | 是 — 3+ 组件时自动建议画图 |-| 布局规范 | 无 — 每次结果不一致 | 按复杂度分级间距、路由走廊、hub 居中策略 |-| 配色方案 | 随机/不一致 | 7 色语义系统(蓝=服务、绿=数据库、紫=安全…) |-| 连线路由规则 | 基础 | 锚点分配、连接分布、走廊绕行 |-| 容器/分组 | 无 | Swimlane、Group、自定义容器 + 父子嵌套 |-| 嵌入式导出 | 否 | 是 — `--embed-diagram` 保持导出文件可编辑 |-| 中文支持 | 否 | 是 — "画图"、"架构图"、"流程图" |+| Feature | Native Claude Code | This skill |+|---------|-------------------|------------|+| Generate draw.io XML | Yes — Claude knows the format | Yes |+| Self-check after export | No | Yes — reads PNG and auto-fixes 6 issue types |+| Iterative review loop | No — must manually re-prompt | Yes — targeted edits, 5-round safety valve |+| Proactive triggers | No — only when explicitly asked | Yes — auto-suggests when 3+ components |+| Layout guidelines | None — varies by run | Complexity-scaled spacing, routing corridors, hub placement |+| Color palette | Random/inconsistent | 7-color semantic system (blue=services, green=DB, purple=auth…) |+| Edge routing rules | Basic | Pin entry/exit points, distribute connections, waypoint corridors |+| Container/group patterns | None | Swimlane, group, custom container with parent-child nesting |+| Embed diagram in export | No | Yes — `--embed-diagram` keeps exported PNG/SVG/PDF editable |+| Chinese language triggers | No | Yes — "画图", "架构图", "流程图" |-### 与其他 draw.io Skills / 工具对比+### vs Other draw.io Skills & Tools-| 功能 | 本 skill | [jgraph/drawio-mcp](https://github.com/jgraph/drawio-mcp)(官方,1.3k⭐) | [bahayonghang/drawio-skills](https://github.com/bahayonghang/drawio-skills)(60⭐) | [GBSOSS/ai-drawio](https://github.com/GBSOSS/ai-drawio)(63⭐) |+| Feature | This skill | [jgraph/drawio-mcp](https://github.com/jgraph/drawio-mcp) (official, 1.3k⭐) | [bahayonghang/drawio-skills](https://github.com/bahayonghang/drawio-skills) (60⭐) | [GBSOSS/ai-drawio](https://github.com/GBSOSS/ai-drawio) (63⭐) ||---------|-----------|---------------|-------------------|--------------|-| **方式** | 纯 SKILL.md | SKILL.md / MCP / Project | YAML DSL + MCP | 插件 + 浏览器 |-| **依赖** | 仅 draw.io 桌面版 | draw.io 桌面版 | MCP 服务(`npx`) | 浏览器 + 本地服务 |-| **自检** | ✅ 2 轮自动修复 | ❌ | ❌ | ❌ 截图 |-| **迭代审查** | ✅ 5 轮循环 | ❌ 一次生成 | ✅ 3 种工作流 | ❌ |-| **布局指南** | ✅ 按复杂度分级 | ✅ 基础间距 | ❌ 依赖 MCP | ❌ |-| **配色系统** | ✅ 7 色语义 | ❌ | ✅ 5 种主题 | ❌ |-| **容器/分组** | ✅ swimlane + group | ✅ 详细 | ❌ | ❌ |-| **嵌入式导出** | ✅ `--embed-diagram` | ✅ | ❌ | ❌ |-| **连线路由** | ✅ 走廊 + waypoints | ✅ 箭头间距规则 | ❌ | ❌ |-| **中文支持** | ✅ 触发词 + 文档 | ❌ | ❌ | ✅ |-| **云图标** | AWS 基础 | ❌ | ✅ AWS/GCP/Azure/K8s | ❌ |-| **零配置** | ✅ 复制 SKILL.md | ✅ | ❌ 需要 `npx` | ❌ 需安装插件 |--### 本 skill 核心优势--1. **自检 + 迭代循环** — 唯一纯 SKILL.md 方案中能自动读取输出、修复问题、支持多轮优化的-2. **零配置、零依赖** — 仅需一个 `SKILL.md` 文件 + draw.io 桌面版,无需 MCP、Python、Node.js、浏览器-3. **专业级布局** — 按复杂度分级间距、路由走廊、hub 居中、连接分布规则-4. **完整中文支持** — 主动触发词("画图"、"架构图")、双语文档--## 支持的图表类型--- **架构图**:微服务架构、云架构(AWS/GCP/Azure)、网络拓扑、部署架构-- **流程图**:业务流程、工作流、决策树、状态机-- **UML**:类图、序列图、用例图-- **数据图**:ER 图、数据流图(DFD)-- **其他**:组织架构图、思维导图、线框图--## 工作流程+| **Approach** | Pure SKILL.md | SKILL.md / MCP / Project | YAML DSL + MCP | Plugin + browser |+| **Dependencies** | draw.io desktop only | draw.io desktop | MCP server (`npx`) | Browser + local server |+| **Self-check** | ✅ 2-round auto-fix | ❌ | ❌ | ❌ screenshot |+| **Iterative review** | ✅ 5-round loop | ❌ generate once | ✅ 3 workflows | ❌ |+| **Layout guidance** | ✅ complexity-scaled | ✅ basic spacing | ❌ relies on MCP | ❌ |+| **Color system** | ✅ 7-color semantic | ❌ | ✅ 5 themes | ❌ |+| **Container/group** | ✅ swimlane + group | ✅ detailed | ❌ | ❌ |+| **Embed diagram** | ✅ `--embed-diagram` | ✅ | ❌ | ❌ |+| **Edge routing** | ✅ corridors + waypoints | ✅ arrowhead rules | ❌ | ❌ |+| **Chinese support** | ✅ triggers + docs | ❌ | ❌ | ✅ |+| **Cloud icons** | AWS basic | ❌ | ✅ AWS/GCP/Azure/K8s | ❌ |+| **Zero-config** | ✅ copy SKILL.md | ✅ | ❌ needs `npx` | ❌ needs plugin install |++### Key advantages of this skill++1. **Self-check + iterative loop** — the only pure-SKILL.md solution that reads its own output and auto-fixes before showing the user, then supports multi-round refinement+2. **Zero-config, zero-dependency** — just one `SKILL.md` file + draw.io desktop. No MCP server, no Python, no Node.js, no browser+3. **Production-grade layout** — complexity-scaled spacing, routing corridors, hub-center strategy, connection distribution rules+4. **Full Chinese support** — proactive triggers ("画图", "架构图"), bilingual documentation++## Supported diagram types++- **Architecture**: microservices, cloud (AWS/GCP/Azure), network topology, deployment+- **Flowcharts**: business processes, workflows, decision trees, state machines+- **UML**: class diagrams, sequence diagrams, use case diagrams+- **Data**: ER diagrams, data flow diagrams (DFD)+- **Other**: org charts, mind maps, wireframes++## How it works<p align="center">- <img src="assets/workflow-cn.png" width="420" alt="工作流程">+ <img src="assets/workflow.png" width="420" alt="Workflow"></p>-## 依赖项+## Dependencies-| 工具 | 用途 |-|------|------|-| `draw.io` 桌面应用 | 原生 CLI,用于将 `.drawio` 导出为 PNG/SVG/PDF |+| Tool | Purpose |+|------|---------|+| `draw.io` desktop app | Native CLI to export `.drawio` → PNG/SVG/PDF |-无需浏览器自动化或 Node.js 依赖。+No browser automation or Node.js dependency required.-## 安装+## Install### macOS```bash-# 推荐方式 — Homebrew+# Recommended — Homebrewbrew install --cask drawio-# 验证安装+# Verifydrawio --version```### Windows-从以下地址下载安装包:https://github.com/jgraph/drawio-desktop/releases+Download and install from: https://github.com/jgraph/drawio-desktop/releases```powershell-# 验证安装+# Verify"C:\Program Files\draw.io\draw.io.exe" --version```### Linux-从以下地址下载 `.deb` 或 `.rpm` 包:https://github.com/jgraph/drawio-desktop/releases+Download `.deb` or `.rpm` from: https://github.com/jgraph/drawio-desktop/releases```bash-# 无头导出(Linux 服务器无显示器时必须)+# Headless export (required on Linux servers without display)sudo apt install xvfb # Debian/Ubuntuxvfb-run -a drawio --version```-### 平台说明+### Platform notes-| 平台 | 额外步骤 |-|------|----------|-| **macOS** | Homebrew 安装后无需额外操作 |-| **Windows** | 如不在 PATH 中,使用完整路径 |-| **Linux** | 无头导出时命令前加 `xvfb-run -a` |+| Platform | Extra step |+|----------|------------|+| **macOS** | No extra steps after Homebrew install |+| **Windows** | Use full path if not in PATH |+| **Linux** | Wrap commands with `xvfb-run -a` for headless export |-## Skill 安装+## Skill Installation### Claude Code```bash-# 全局安装(所有项目可用)+# Global install (available in all projects)git clone https://github.com/Agents365-ai/drawio-skill.git ~/.claude/skills/drawio-# 项目级安装+# Project-level installgit clone https://github.com/Agents365-ai/drawio-skill.git .claude/skills/drawio```### OpenClaw```bash-# 通过 ClawHub 安装+# Via ClawHubclawhub install drawio-# 手动安装+# Manual installgit clone https://github.com/Agents365-ai/drawio-skill.git ~/.openclaw/skills/drawio-# 项目级安装+# Project-level installgit clone https://github.com/Agents365-ai/drawio-skill.git skills/drawio```### Hermes Agent```bash-# 安装到 design 分类+# Install under design categorygit clone https://github.com/Agents365-ai/drawio-skill.git ~/.hermes/skills/design/drawio```-或在 `~/.hermes/config.yaml` 中添加外部目录:+Or add an external directory in `~/.hermes/config.yaml`:```yamlskills:@@ -155,119 +155,118 @@ skills:### OpenAI Codex```bash-# 用户级安装+# User-level installgit clone https://github.com/Agents365-ai/drawio-skill.git ~/.agents/skills/drawio-# 项目级安装+# Project-level installgit clone https://github.com/Agents365-ai/drawio-skill.git .agents/skills/drawio```### SkillsMP-在 [skillsmp.com](https://skillsmp.com) 搜索 `drawio` 或使用 CLI:+Search for `drawio` on [skillsmp.com](https://skillsmp.com) or use the CLI:```bashskills install drawio```-### 安装路径总结+### Installation paths summary-| 平台 | 全局路径 | 项目路径 |-|------|----------|----------|+| Platform | Global path | Project path |+|----------|-------------|--------------|| Claude Code | `~/.claude/skills/drawio/` | `.claude/skills/drawio/` || OpenClaw | `~/.openclaw/skills/drawio/` | `skills/drawio/` |-| Hermes Agent | `~/.hermes/skills/design/drawio/` | 通过 `external_dirs` 配置 |+| Hermes Agent | `~/.hermes/skills/design/drawio/` | Via `external_dirs` config || OpenAI Codex | `~/.agents/skills/drawio/` | `.agents/skills/drawio/` |-| SkillsMP | N/A(通过 CLI 安装) | N/A |+| SkillsMP | N/A (installed via CLI) | N/A |-## 使用方式+## Usage-直接描述你想要的图表:+Just describe what you want:```-画一个微服务电商架构图,包含 Mobile/Web/Admin 客户端,API Gateway,-Auth/User/Order/Product/Payment 微服务,Kafka 消息队列,Notification 服务,-以及各自独立的数据库+Create a microservices e-commerce architecture with API Gateway, auth/user/order/product/payment services,+Kafka message queue, notification service, and separate databases for each service```-Claude 会自动生成 `.drawio` 文件并导出为 PNG。+Claude will generate the `.drawio` XML file and export it to PNG automatically.-## 示例+## Example-**提示词:**-> 画一个微服务电商架构图,包含 Mobile/Web/Admin 客户端,API Gateway(含认证+限流+路由),-> Auth/User/Order/Product/Payment 微服务,Kafka 消息队列,Notification 服务,-> User DB / Order DB / Product DB / Redis Cache / Stripe API+**Prompt:**+> Create a microservices e-commerce architecture with Mobile/Web/Admin clients, API Gateway,+> Auth/User/Order/Product/Payment services, Kafka message queue, Notification service,+> and User DB / Order DB / Product DB / Redis Cache / Stripe API-**输出效果:**+**Output:**-+-## 拓扑示例+## Topology demos-本 skill 支持多种图表拓扑,线条路由清晰 —— 不会穿越无关的形状。+The skill handles various diagram topologies with clean edge routing — no lines crossing through shapes.-### 星形拓扑(7 个节点)+### Star topology (7 nodes)-中央消息代理 + 6 个微服务辐射排列。连线从不同方向进入 Kafka,零交叉。+Central message broker with 6 microservices radiating outward. Edges enter Kafka from different sides, zero crossings.-+-### 分层流程(10 个节点,4 层)+### Layered flow (10 nodes, 4 tiers)-电商架构,含 2 条交叉连线:订单→商品(同层水平)和 认证→Redis(对角线,经路由走廊绕行)。所有线条路由清晰。+E-commerce architecture with 2 cross-connections: Order→Product (same-tier horizontal) and Auth→Redis (diagonal via routing corridor). All edges route cleanly.-+-### 环形 / 循环(8 个节点)+### Ring / cycle (8 nodes)-CI/CD 流水线,包含闭合回路和 2 个分支。线条沿矩形外围流动,不穿越内部区域。+CI/CD pipeline with a closed loop and 2 spur branches. Edges flow along the perimeter without crossing the interior.-+-## 多平台支持+## Multi-Platform Support-本 skill 兼容以下平台:+This skill is compatible with the following platforms:-| 平台 | 支持状态 | 说明 |-|------|----------|------|-| **Claude Code** | ✅ 完全支持 | 原生 SKILL.md 格式 |-| **OpenClaw** | ✅ 完全支持 | `metadata.openclaw` 命名空间,依赖检测,安装器 |-| **Hermes Agent** | ✅ 完全支持 | `metadata.hermes` 命名空间,标签分类,工具门控 |-| **OpenAI Codex** | ✅ 完全支持 | `agents/openai.yaml` 侧车文件 |-| **SkillsMP** | ✅ 可索引 | GitHub topics 已配置 |+| Platform | Status | Details |+|----------|--------|---------|+| **Claude Code** | ✅ Full support | Native SKILL.md format |+| **OpenClaw** | ✅ Full support | `metadata.openclaw` namespace, dependency gating, installer |+| **Hermes Agent** | ✅ Full support | `metadata.hermes` namespace, tags, tool gating |+| **OpenAI Codex** | ✅ Full support | `agents/openai.yaml` sidecar file |+| **SkillsMP** | ✅ Indexed | GitHub topics configured |-## 文件说明+## Files-- `SKILL.md` — **唯一必需的文件**,所有平台加载的 skill 指令-- `agents/openai.yaml` — OpenAI Codex 专用配置(界面、策略)-- `README.md` — 本文件(中文,GitHub 首页显示)-- `README_EN.md` — 英文说明-- `assets/` — 示例图表和工作流图片+- `SKILL.md` — **the only required file**. Loaded by all platforms as the skill instructions.+- `agents/openai.yaml` — OpenAI Codex-specific configuration (UI, policy)+- `README.md` — this file (English, displayed on GitHub homepage)+- `README_CN.md` — Chinese documentation+- `assets/` — example diagrams and workflow images-> **提示:** 仅 `SKILL.md` 是 skill 运行所必需的。`agents/openai.yaml` 仅 Codex 需要。`assets/`、`README.md` 和 `README_EN.md` 仅为文档用途,可以安全删除以节省空间。+> **Note:** Only `SKILL.md` is needed for the skill to work. `agents/openai.yaml` is only needed for Codex. The `assets/`, `README.md`, and `README_EN.md` files are documentation only and can be safely deleted to save space.-> 所有示例图表均由 Claude Code 配合 Claude Opus 4.6 模型生成。+> All example diagrams were generated in Claude Code with Claude Opus 4.6.-## 开源协议+## LicenseMIT-## 支持作者+## Support-如果这个 skill 对你有帮助,欢迎支持作者:+If this skill helps you, consider supporting the author:<table><tr><td align="center">- <img src="https://raw.githubusercontent.com/Agents365-ai/images_payment/main/qrcode/wechat-pay.png" width="180" alt="微信支付">+ <img src="https://raw.githubusercontent.com/Agents365-ai/images_payment/main/qrcode/wechat-pay.png" width="180" alt="WeChat Pay"><br>- <b>微信支付</b>+ <b>WeChat Pay</b></td><td align="center">- <img src="https://raw.githubusercontent.com/Agents365-ai/images_payment/main/qrcode/alipay.png" width="180" alt="支付宝">+ <img src="https://raw.githubusercontent.com/Agents365-ai/images_payment/main/qrcode/alipay.png" width="180" alt="Alipay"><br>- <b>支付宝</b>+ <b>Alipay</b></td><td align="center"><img src="https://raw.githubusercontent.com/Agents365-ai/images_payment/main/qrcode/buymeacoffee.png" width="180" alt="Buy Me a Coffee">@@ -277,7 +276,7 @@ MIT</tr></table>-## 作者+## Author**Agents365-ai**diff --git a/README_CN.md b/README_CN.mdnew file mode 100644index 0000000..196d01d--- /dev/null+++ b/README_CN.md@@ -0,0 +1,285 @@+# drawio-skill++[English](README.md)++## 功能说明++- 根据自然语言描述生成 `.drawio` XML 文件+- 使用 draw.io 桌面版原生 CLI 将图表导出为 PNG、SVG、PDF 或 JPG+- 支持多页图表和分层分组+- 迭代设计:预览、获取反馈、反复优化直到图表满意为止+- 当图表有助于解释复杂系统时自动触发++## 对比++### 与原生 Claude Code(无 skill)对比++| 功能 | 原生 Claude Code | 本 skill |+|------|-----------------|---------|+| 生成 draw.io XML | 是 — Claude 本身了解格式 | 是 |+| 导出后自检 | 否 | 是 — 读取 PNG 自动修复 6 类问题 |+| 迭代反馈循环 | 否 — 需手动重新提问 | 是 — 定向编辑,5 轮安全阀 |+| 主动触发 | 否 — 仅在明确要求时 | 是 — 3+ 组件时自动建议画图 |+| 布局规范 | 无 — 每次结果不一致 | 按复杂度分级间距、路由走廊、hub 居中策略 |+| 配色方案 | 随机/不一致 | 7 色语义系统(蓝=服务、绿=数据库、紫=安全…) |+| 连线路由规则 | 基础 | 锚点分配、连接分布、走廊绕行 |+| 容器/分组 | 无 | Swimlane、Group、自定义容器 + 父子嵌套 |+| 嵌入式导出 | 否 | 是 — `--embed-diagram` 保持导出文件可编辑 |+| 中文支持 | 否 | 是 — "画图"、"架构图"、"流程图" |++### 与其他 draw.io Skills / 工具对比++| 功能 | 本 skill | [jgraph/drawio-mcp](https://github.com/jgraph/drawio-mcp)(官方,1.3k⭐) | [bahayonghang/drawio-skills](https://github.com/bahayonghang/drawio-skills)(60⭐) | [GBSOSS/ai-drawio](https://github.com/GBSOSS/ai-drawio)(63⭐) |+|---------|-----------|---------------|-------------------|--------------|+| **方式** | 纯 SKILL.md | SKILL.md / MCP / Project | YAML DSL + MCP | 插件 + 浏览器 |+| **依赖** | 仅 draw.io 桌面版 | draw.io 桌面版 | MCP 服务(`npx`) | 浏览器 + 本地服务 |+| **自检** | ✅ 2 轮自动修复 | ❌ | ❌ | ❌ 截图 |+| **迭代审查** | ✅ 5 轮循环 | ❌ 一次生成 | ✅ 3 种工作流 | ❌ |+| **布局指南** | ✅ 按复杂度分级 | ✅ 基础间距 | ❌ 依赖 MCP | ❌ |+| **配色系统** | ✅ 7 色语义 | ❌ | ✅ 5 种主题 | ❌ |+| **容器/分组** | ✅ swimlane + group | ✅ 详细 | ❌ | ❌ |+| **嵌入式导出** | ✅ `--embed-diagram` | ✅ | ❌ | ❌ |+| **连线路由** | ✅ 走廊 + waypoints | ✅ 箭头间距规则 | ❌ | ❌ |+| **中文支持** | ✅ 触发词 + 文档 | ❌ | ❌ | ✅ |+| **云图标** | AWS 基础 | ❌ | ✅ AWS/GCP/Azure/K8s | ❌ |+| **零配置** | ✅ 复制 SKILL.md | ✅ | ❌ 需要 `npx` | ❌ 需安装插件 |++### 本 skill 核心优势++1. **自检 + 迭代循环** — 唯一纯 SKILL.md 方案中能自动读取输出、修复问题、支持多轮优化的+2. **零配置、零依赖** — 仅需一个 `SKILL.md` 文件 + draw.io 桌面版,无需 MCP、Python、Node.js、浏览器+3. **专业级布局** — 按复杂度分级间距、路由走廊、hub 居中、连接分布规则+4. **完整中文支持** — 主动触发词("画图"、"架构图")、双语文档++## 支持的图表类型++- **架构图**:微服务架构、云架构(AWS/GCP/Azure)、网络拓扑、部署架构+- **流程图**:业务流程、工作流、决策树、状态机+- **UML**:类图、序列图、用例图+- **数据图**:ER 图、数据流图(DFD)+- **其他**:组织架构图、思维导图、线框图++## 工作流程++<p align="center">+ <img src="assets/workflow-cn.png" width="420" alt="工作流程">+</p>++## 依赖项++| 工具 | 用途 |+|------|------|+| `draw.io` 桌面应用 | 原生 CLI,用于将 `.drawio` 导出为 PNG/SVG/PDF |++无需浏览器自动化或 Node.js 依赖。++## 安装++### macOS++```bash+# 推荐方式 — Homebrew+brew install --cask drawio++# 验证安装+drawio --version+```++### Windows++从以下地址下载安装包:https://github.com/jgraph/drawio-desktop/releases++```powershell+# 验证安装+"C:\Program Files\draw.io\draw.io.exe" --version+```++### Linux++从以下地址下载 `.deb` 或 `.rpm` 包:https://github.com/jgraph/drawio-desktop/releases++```bash+# 无头导出(Linux 服务器无显示器时必须)+sudo apt install xvfb # Debian/Ubuntu+xvfb-run -a drawio --version+```++### 平台说明++| 平台 | 额外步骤 |+|------|----------|+| **macOS** | Homebrew 安装后无需额外操作 |+| **Windows** | 如不在 PATH 中,使用完整路径 |+| **Linux** | 无头导出时命令前加 `xvfb-run -a` |++## Skill 安装++### Claude Code++```bash+# 全局安装(所有项目可用)+git clone https://github.com/Agents365-ai/drawio-skill.git ~/.claude/skills/drawio++# 项目级安装+git clone https://github.com/Agents365-ai/drawio-skill.git .claude/skills/drawio+```++### OpenClaw++```bash+# 通过 ClawHub 安装+clawhub install drawio++# 手动安装+git clone https://github.com/Agents365-ai/drawio-skill.git ~/.openclaw/skills/drawio++# 项目级安装+git clone https://github.com/Agents365-ai/drawio-skill.git skills/drawio+```++### Hermes Agent++```bash+# 安装到 design 分类+git clone https://github.com/Agents365-ai/drawio-skill.git ~/.hermes/skills/design/drawio+```++或在 `~/.hermes/config.yaml` 中添加外部目录:++```yaml+skills:+ external_dirs:+ - ~/myskills/drawio-skill+```++### OpenAI Codex++```bash+# 用户级安装+git clone https://github.com/Agents365-ai/drawio-skill.git ~/.agents/skills/drawio++# 项目级安装+git clone https://github.com/Agents365-ai/drawio-skill.git .agents/skills/drawio+```++### SkillsMP++在 [skillsmp.com](https://skillsmp.com) 搜索 `drawio` 或使用 CLI:++```bash+skills install drawio+```++### 安装路径总结++| 平台 | 全局路径 | 项目路径 |+|------|----------|----------|+| Claude Code | `~/.claude/skills/drawio/` | `.claude/skills/drawio/` |+| OpenClaw | `~/.openclaw/skills/drawio/` | `skills/drawio/` |+| Hermes Agent | `~/.hermes/skills/design/drawio/` | 通过 `external_dirs` 配置 |+| OpenAI Codex | `~/.agents/skills/drawio/` | `.agents/skills/drawio/` |+| SkillsMP | N/A(通过 CLI 安装) | N/A |++## 使用方式++直接描述你想要的图表:++```+画一个微服务电商架构图,包含 Mobile/Web/Admin 客户端,API Gateway,+Auth/User/Order/Product/Payment 微服务,Kafka 消息队列,Notification 服务,+以及各自独立的数据库+```++Claude 会自动生成 `.drawio` 文件并导出为 PNG。++## 示例++**提示词:**+> 画一个微服务电商架构图,包含 Mobile/Web/Admin 客户端,API Gateway(含认证+限流+路由),+> Auth/User/Order/Product/Payment 微服务,Kafka 消息队列,Notification 服务,+> User DB / Order DB / Product DB / Redis Cache / Stripe API++**输出效果:**++++## 拓扑示例++本 skill 支持多种图表拓扑,线条路由清晰 —— 不会穿越无关的形状。++### 星形拓扑(7 个节点)++中央消息代理 + 6 个微服务辐射排列。连线从不同方向进入 Kafka,零交叉。++++### 分层流程(10 个节点,4 层)++电商架构,含 2 条交叉连线:订单→商品(同层水平)和 认证→Redis(对角线,经路由走廊绕行)。所有线条路由清晰。++++### 环形 / 循环(8 个节点)++CI/CD 流水线,包含闭合回路和 2 个分支。线条沿矩形外围流动,不穿越内部区域。++++## 多平台支持++本 skill 兼容以下平台:++| 平台 | 支持状态 | 说明 |+|------|----------|------|+| **Claude Code** | ✅ 完全支持 | 原生 SKILL.md 格式 |+| **OpenClaw** | ✅ 完全支持 | `metadata.openclaw` 命名空间,依赖检测,安装器 |+| **Hermes Agent** | ✅ 完全支持 | `metadata.hermes` 命名空间,标签分类,工具门控 |+| **OpenAI Codex** | ✅ 完全支持 | `agents/openai.yaml` 侧车文件 |+| **SkillsMP** | ✅ 可索引 | GitHub topics 已配置 |++## 文件说明++- `SKILL.md` — **唯一必需的文件**,所有平台加载的 skill 指令+- `agents/openai.yaml` — OpenAI Codex 专用配置(界面、策略)+- `README.md` — 英文说明(GitHub 首页显示)+- `README_CN.md` — 本文件(中文)+- `assets/` — 示例图表和工作流图片++> **提示:** 仅 `SKILL.md` 是 skill 运行所必需的。`agents/openai.yaml` 仅 Codex 需要。`assets/`、`README.md` 和 `README_EN.md` 仅为文档用途,可以安全删除以节省空间。++> 所有示例图表均由 Claude Code 配合 Claude Opus 4.6 模型生成。++## 开源协议++MIT++## 支持作者++如果这个 skill 对你有帮助,欢迎支持作者:++<table>+ <tr>+ <td align="center">+ <img src="https://raw.githubusercontent.com/Agents365-ai/images_payment/main/qrcode/wechat-pay.png" width="180" alt="微信支付">+ <br>+ <b>微信支付</b>+ </td>+ <td align="center">+ <img src="https://raw.githubusercontent.com/Agents365-ai/images_payment/main/qrcode/alipay.png" width="180" alt="支付宝">+ <br>+ <b>支付宝</b>+ </td>+ <td align="center">+ <img src="https://raw.githubusercontent.com/Agents365-ai/images_payment/main/qrcode/buymeacoffee.png" width="180" alt="Buy Me a Coffee">+ <br>+ <b>Buy Me a Coffee</b>+ </td>+ </tr>+</table>++## 作者++**Agents365-ai**++- Bilibili: https://space.bilibili.com/441831884+- GitHub: https://github.com/Agents365-ai