O que Habilidade Diagramadora draw.io faz?
Quando usar esta habilidade
- O usuário solicita um fluxograma, mapa de processo ou diagrama de fluxo de trabalho
- O usuário solicita um ERD, diagrama de banco de dados ou modelo de relacionamento entre entidades
- O usuário solicita um diagrama de arquitetura, sistema ou componentes
- O usuário solicita um diagrama de classe, sequência ou UML
- O usuário diz "draw.io", "diagrama", "fluxograma", "visualize este processo"
- O usuário pede para atualizar, corrigir ou estender um arquivo
.drawioexistente
OBRIGATÓRIO — Leia antes de gerar qualquer coisa
- Detecte o tipo de diagrama primeiro — consulte as referências em diagram-types/ antes de escrever XML
- Aplique os padrões universais de estilo de caixa — veja
references/box-style-standards.md - Todas as posições são codificadas manualmente — não existe auto-layout no XML do draw.io
- Execute o loop de revisão visual após cada exportação — veja
references/visual-review-protocol.md - Nunca declare concluído sem uma passada visual — exporte PNG, leia, corrija, repita
Detecção de tipo de diagrama
| O usuário diz... | Arquivo de referência |
|---|---|
| "fluxograma", "processo", "passos", "fluxo de trabalho", "SOP" | references/diagram-types/flowchart.md |
| "ERD", "banco de dados", "tabelas", "entidades", "chave estrangeira" | references/diagram-types/erd.md |
| "arquitetura", "sistema", "componentes", "serviços" | references/diagram-types/layout.md |
| "classe", "UML", "herança", "métodos", "atributos" | references/diagram-types/class.md |
| "sequência", "interação", "linha de vida", "chamadas de ator" | references/diagram-types/sequence.md |
Fluxo de trabalho padrão de geração
Passo 1 — Carregar a referência do tipo
Leia o arquivo references/diagram-types/ correto antes de escrever qualquer XML.
Passo 2 — Planejar todos os elementos
Liste cada nó, conexão e seção antes de codificar. Não improvise o layout durante a construção.
Passo 3 — Aplicar estilo de caixa universal
Cada nó deve incluir os atributos universais de espaçamento de references/box-style-standards.md.
Passo 4 — Criar pasta de saída e escrever o XML
mkdir -p ./diagrams
Salve em:
./diagrams/<nome-do-diagrama>.drawio
Lista de verificação pré-salvamento:
- Todos os elementos
mxCellpossuem IDs numéricos sequenciais únicos - Espaçamento universal de caixa aplicado ao estilo de cada nó:
spacingLeft=12;spacingRight=12;spacingTop=10;spacingBottom=10;verticalAlign=top; - Setas usam roteamento encadeado, não dispersão de uma única fonte para vários destinos
- Espaçamento mínimo de 15–20px entre quaisquer duas caixas (verifique o final da lista de subitens vs. o início da próxima seção)
- Alturas calculadas com a fórmula em box-style-standards.md (×16px por linha em fontSize=10)
- Painéis de texto largo (notas, descrições) têm 530px+ de largura — não 460px ou menos
- Sem
\nliterais em atributos de valor — use
para quebras de linha -
verticalAlign=topem todas as caixas de conteúdo com várias linhas
Passo 5 — Exportar PNG e executar o loop de revisão visual
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format png --output ./diagrams/<nome>.png --scale 2 --border 30 ./diagrams/<nome>.drawio
Em seguida, siga o protocolo completo em references/visual-review-protocol.md.
Passo 6 — Entregar
Envie o PNG para o usuário primeiro. Para diagramas maiores, envie capturas de tela das seções (topo, meio, base) antes da imagem completa.
Depois pergunte quais outros formatos eles desejam:
O diagrama está pronto. Qual formato você gostaria?
1 — Imagem PNG (pronta para visualizar)
2 — Arquivo .drawio (editável no draw.io)
3 — SVG (vetor escalável)
4 — PDF
5 — Todos os anteriores
Responda com o(s) número(s) da sua escolha.
Para entrega no Drive ou caminhos de saída personalizados, siga references/workflow-sop.md.
Referência CLI
# macOS — Exportar PNG (padrão)
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format png --output <out.png> --scale 2 --border 30 <arquivo.drawio>
# macOS — Exportar PNG de alta resolução
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format png --output <out.png> --scale 3 --border 30 <arquivo.drawio>
# macOS — Exportar SVG
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format svg --output <out.svg> <arquivo.drawio>
# macOS — Exportar PDF
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format pdf --output <out.pdf> <arquivo.drawio>
# Linux / headless — Exportar PNG
xvfb-run -a drawio --export --format png --output <out.png> --scale 2 --border 30 <arquivo.drawio>
# Linux / headless — Exportar SVG
xvfb-run -a drawio --export --format svg --output <out.svg> <arquivo.drawio>