convez.ai
SkillDevOps & InfraestruturaIntermediário
zhh907

DrawIO Arch Skill

zhh907/drawio-arch-skill

Gera diagramas arquiteturais profissionais em draw.io com design system

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill para Claude Code que gera diagramas profissionais em draw.io com 17 tipos (arquitetura, fluxo de dados, ER, topologia), 5 temas de cor, layout automático e verificação de qualidade. Implementa um sistema de design unificado com 4 camadas de negócio e múltiplos estilos de módulos.

Instalação

$npx convez-ai zhh907/drawio-arch-skill

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Documentar arquitetura de sistemas em camadas (web, microserviços, cloud)
  • Criar diagramas de fluxo de dados, topologia de rede e deployment K8s
  • Gerar mapas de capacidades de negócio, roadmaps e organogramas
  • Produzir wireframes, diagramas ER e sequência de APIs

Veredito

Ferramenta sólida e completa para engenheiros documentarem arquiteturas em draw.io com consistência visual. Suporta todo ciclo de projeto (análise, design, deployment) e oferece automação real de layout e qualidade — prática para times que precisam de diagramas versionáveis.

README

A tradução para o português deste README ainda está na fila.

drawio-arch-skill

English | 中文


English

A Claude Code Skill for generating professional draw.io architecture diagrams with a unified design system.

Features

  • 17 Diagram Types — covers the full project lifecycle
  • 5 Color Themes — Ocean Blue, Dark Night, Forest Green, Sunset Orange, Monochrome
  • 4-Layer Business Standard Model — L1 Core / L2 Supporting / L3 Common / L4 Process
  • Automated Layout — fill formulas + 余量分配法 for uniform module distribution
  • Quality Checklist — anti-overlap, content density, anti-pattern self-verification
  • 8 Module Styles — primary, secondary, outlined, database, decision, actor, etc.
  • 4 Container Levels — layer, sub-container, nested, board

Diagram Types

#TypeCommandDescription
01System ArchitecturesystemLayered system architecture
02Business ArchitecturebusinessBusiness capability map
03Deployment TopologytopologyK8s / server deployment
04Data FlowdataflowData flow from input to output
05Component DiagramcomponentModule dependency graph
06Sequence DiagramsequenceAPI call sequences
07ER DiagramerEntity-relationship diagram
08Network TopologynetworkVPC / subnet / load balancer
09Class DiagramclassClass inheritance and interfaces
10Activity DiagramactivityBusiness process / algorithm flow
11State MachinestateState transitions
12API Mapapi-mapAll API endpoints overview
13WireframewireframePage layout prototype
14Org Chartorg-chartTeam / role structure
15MindmapmindmapTech stack / knowledge map
16TimelinetimelineProject roadmap and milestones
17ComparisoncomparisonBefore/After or A/B comparison

Color Themes

ThemeStyleBest For
Ocean Blue (default)Professional, calmEnterprise architecture, technical docs
Dark NightDark mode, modernPresentations, social media
Forest GreenNatural, ecoDevOps dashboards, health tech
Sunset OrangeWarm, energeticProduct roadmaps, startup pitches
MonochromeMinimal, print-friendlyPrint documents, academic papers

Installation

# 1. Clone this repository
git clone https://github.com/zhh907/drawio-arch-skill.git

# 2. Copy the skill to your Claude Code skills directory
mkdir -p ~/.claude/skills/drawio-arch
cp drawio-arch-skill/SKILL.md ~/.claude/skills/drawio-arch/SKILL.md

# 3. Restart Claude Code (or start a new session)
# The skill is now available via /drawio-arch

Usage

# Generate a single diagram
/drawio-arch system A three-tier web app: Nginx → Spring Boot → MySQL
/drawio-arch er User, Order, Product entity relationships
/drawio-arch sequence Login to order placement call chain

# Generate all 17 diagrams for a project
/drawio-arch all

# Choose a theme
/drawio-arch topology K8s cluster deployment --theme dark-night
/drawio-arch dataflow Data pipeline --theme forest-green

# Audit or fix existing diagrams
/drawio-arch audit 01-system-architecture.drawio
/drawio-arch fix 03-deployment-topology.drawio

Design System

The skill defines a complete design system with parameterized color tokens. All module, container, and connector styles reference theme tokens (e.g., {PRIMARY_MID}, {ACCENT}), so switching themes only requires swapping the palette — layout and typography rules stay the same.

See SKILL.md for the complete specification.


中文

一个 Claude Code Skill,用于生成专业级 draw.io 架构图,内置统一设计系统。

特性

  • 17 种图表类型 — 覆盖项目全生命周期
  • 5 套配色主题 — 海洋蓝、暗夜、森林绿、日落橙、单色
  • 4 层业务标准模型 — L1 核心 / L2 支撑 / L3 通用 / L4 流程
  • 自动布局 — 均分填充公式 + 余量分配法,模块等宽等距
  • 质量检查清单 — 防重叠、内容密度、反模式自检
  • 8 种模块样式 — 核心模块、二级模块、描边、数据库、决策、角色等
  • 4 级容器 — 图层容器、子容器、嵌套容器、全局底板

图表类型

#类型命令说明
01系统架构图system分层系统架构
02业务架构图business业务能力地图
03部署拓扑图topologyK8s / 服务器部署
04数据流图dataflow从输入到输出的数据流向
05组件依赖图component模块间依赖关系
06时序图sequence接口调用时序
07ER 图er实体关系图
08网络拓扑图networkVPC / 子网 / 负载均衡
09类图class类继承和接口实现
10活动图activity业务流程 / 算法步骤
11状态机图state状态流转
12API 地图api-map全部 API 端点总览
13线框图wireframe页面布局原型
14组织架构图org-chart团队 / 角色结构
15思维导图mindmap技术栈 / 知识体系
16排期路线图timeline版本规划和里程碑
17方案对比图comparisonBefore/After 或 A/B 对比

配色主题

主题风格适用场景
海洋蓝(默认)专业沉稳企业架构、技术文档
暗夜暗黑现代演示汇报、社交媒体
森林绿自然生态DevOps 仪表盘、健康科技
日落橙温暖活力产品路线图、创业路演
单色极简打印文档、学术论文

安装

# 1. 克隆仓库
git clone https://github.com/zhh907/drawio-arch-skill.git

# 2. 复制 Skill 到 Claude Code 的 skills 目录
mkdir -p ~/.claude/skills/drawio-arch
cp drawio-arch-skill/SKILL.md ~/.claude/skills/drawio-arch/SKILL.md

# 3. 重启 Claude Code 或开启新会话
# 输入 /drawio-arch 即可使用

使用方式

# 生成单张图表
/drawio-arch system 金融量化平台微服务架构
/drawio-arch er 订单、用户、商品实体关系
/drawio-arch sequence 用户登录到下单的完整调用链路

# 一键生成项目全部 17 种图表
/drawio-arch all

# 选择主题
/drawio-arch topology K8s集群部署 --theme dark-night
/drawio-arch dataflow 数据管道 --theme forest-green

# 审计或修复已有图表
/drawio-arch audit 01-系统架构图.drawio
/drawio-arch fix 03-部署拓扑图.drawio

设计系统

Skill 定义了一套完整的设计系统,所有模块、容器和连接线的样式通过参数化色标(如 {PRIMARY_MID}、{ACCENT})引用主题色值。切换主题只需替换色板,布局和排版规则完全不变。

核心规则:

  • 所有模块:rounded=1;arcSize=6
  • 所有容器:swimlane + container=1
  • 同行模块间距统一(4px 或 8px)
  • 5 级排版层级(H1-H5)
  • 4 层业务标准模型(L1 核心 / L2 支撑 / L3 通用 / L4 流程)

完整规范见 SKILL.md。


Examples / 示例

examples/ 目录包含 5 套主题的完整示例,共 33 个文件:

Theme / 主题FilesDiagrams
ocean-blue16全部 17 种图表类型
dark-night5架构图、数据流、拓扑、组件 + 截图
forest-green4架构图、数据流、拓扑、组件
sunset-orange4架构图、数据流、拓扑、组件
monochrome4架构图、数据流、拓扑、组件

所有 .drawio 文件可直接用 draw.io 打开。

Project Structure / 项目结构

drawio-arch-skill/
├── SKILL.md                    # Skill 核心 — 完整设计系统规范
├── README.md                   # 本文件
├── LICENSE                     # MIT
└── examples/                   # 示例图表
    ├── ocean-blue/             # 海洋蓝主题(17 种图表)
    ├── dark-night/             # 暗夜主题 + 截图
    ├── forest-green/           # 森林绿主题
    ├── sunset-orange/          # 日落橙主题
    └── monochrome/             # 单色主题

Requirements / 环境要求

License

MIT

Ver o original no GitHub

Bom para

Relacionados