CommunityImagemgithub.com

Criador de Fluxogramas SVG (Estilo Desenhado à Mão)

Cria fluxogramas e diagramas SVG com estilo desenhado à mão a partir de descrições do usuário. Suporta especificação de proporção (16:9, 4:3, 1:1, A4 ou proporções personalizadas W:H).

O que é Criador de Fluxogramas SVG (Estilo Desenhado à Mão)?

Esta habilidade é projetada para agentes de IA que precisam gerar diagramas visualmente atraentes e com aparência natural a partir de descrições textuais. Ela transforma descrições de processos, sistemas ou fluxos de trabalho em arquivos SVG com um estilo distintivo de esboço manual — bordas irregulares, preenchimentos hachurados e fontes que imitam caligrafia — em vez de diagramas corporativos rígidos. A habilidade oferece suporte a várias proporções predefinidas (16:9, 4:3, 1:1, A4) e personalizadas, adaptando o layout (horizontal, vertical ou radial) para aproveitar melhor o espaço da tela. O processo de trabalho é bem definido: o agente primeiro interpreta a descrição para extrair atores, etapas e conexões; depois, planeja o layout com base na proporção; em seguida, gera o código SVG utilizando técnicas específicas como filtros de deslocamento para o efeito de esboço, padrões de hachura e fontes especializadas (Ma Shan Zheng para texto chinês, Comic Sans MS para inglês). Um ponto crítico é que o agente deve garantir que as setas e linhas conectoras nunca recebam o filtro de deslocamento, pois isso pode torná-las invisíveis. A habilidade também realiza uma auto-verificação rigorosa das conexões e da qualidade visual, convertendo o SVG para PNG para inspeção antes de apresentar o resultado ao usuário. Ela é compatível com plataformas como Claude Code, Cursor e Codex, sendo ideal para criar diagramas de arquitetura, fluxogramas de processo, mapas mentais e outras representações visuais de sistemas.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/retrocognition023/my-agent-skills/tree/HEAD/skills/svg-creator

Installed? Explore more Imagem skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Criador de Fluxogramas SVG (Estilo Desenhado à Mão) faz?

Você transforma descrições faladas/escritas de processos, sistemas ou fluxos de trabalho em belos fluxogramas SVG com estilo desenhado à mão. O resultado deve parecer que alguém esboçou em um quadro branco com marcadores coloridos — não um diagrama corporativo rígido.

Proporção

Todo SVG deve ter uma proporção definida. O usuário pode especificá-la explicitamente, ou o padrão é 16:9 (amigável para apresentações). A proporção determina os atributos viewBox e width/height do elemento <svg>.

Predefinições

NomeProporçãoviewBox TípicoMelhor para
16:916:90 0 1600 900Slides, apresentações, monitores widescreen
4:34:30 0 1200 900Slides tradicionais, documentação
1:11:10 0 1000 1000Mídias sociais, miniaturas quadradas
A4~1:1.4140 0 1000 1414Documentos para impressão, pôsteres verticais
A4-paisagem~1.414:10 0 1414 1000Documentos para impressão no modo paisagem

Proporções personalizadas

O usuário pode especificar qualquer proporção como W:H (ex.: 3:2, 21:9). Calcule o viewBox dimensionando para que a dimensão mais longa tenha ~1400-1600px e a dimensão mais curta siga a proporção.

Como a proporção afeta o layout

  • Formatos largos (16:9, 21:9): Favorecem fluxos da esquerda para a direita. Mais espaço horizontal significa que você pode colocar confortavelmente 4-6 elementos em uma linha. O empilhamento vertical desperdiça espaço.
  • Formatos altos (A4, 9:16): Favorecem fluxos de cima para baixo. Use todo o espaço vertical; limite os elementos horizontais a 2-3 por linha.
  • Quadrado (1:1): Equilibrado — funciona tanto para layouts radiais quanto para grades 2×2/3×3. Bom para mapas conceituais sem um fluxo direcional forte.
  • 4:3: Um bom meio-termo. Funciona para ambas as orientações, mas favorece ligeiramente a horizontal.

Ao planejar o layout na Etapa 2, sempre verifique a proporção primeiro e escolha uma direção de layout que use o espaço disponível naturalmente. Não force um fluxo da esquerda para a direita em uma tela alta ou um fluxo de cima para baixo em uma tela widescreen.

Comportamento padrão

Se o usuário não especificar uma proporção, use 16:9 — funciona bem para a maioria dos diagramas e é imediatamente utilizável em apresentações. Se o conteúdo claramente precisar de uma proporção diferente (ex.: uma hierarquia muito alta), sugira alterá-la, mas não substitua silenciosamente.

Fluxo de Trabalho Geral

  1. Entender e decompor — Analisar a descrição do usuário em módulos/etapas/atores discretos
  2. Determinar a proporção — Usar a proporção especificada pelo usuário ou o padrão 16:9
  3. Planejar o layout — Decidir a estrutura visual, adaptando-se à proporção
  4. Gerar SVG — Escrever SVG limpo com estilo desenhado à mão e viewBox correto
  5. Verificar setas — Autoverificar se toda conexão entre nós tem uma seta visível
  6. Gerar saída e iterar — Fornecer caminhos de arquivo ao usuário, refinar com base no feedback

Etapa 1: Entender e Decompor

Quando o usuário descreve um processo, extraia:

  • Atores/Papéis — Quem são os participantes? (ex.: "PM", "Sistema", "Usuário")
  • Estágios/Fases — Quais são os agrupamentos principais? (ex.: "Fase de Entrada", "Fase de Processamento")
  • Etapas — Quais são as operações individuais dentro de cada estágio?
  • Conexões — Como as coisas fluem? Sequencial? Ramificação? Loops de feedback?

Se a descrição for ambígua, faça perguntas esclarecedoras antes de desenhar.

Etapa 2: Planejar o Layout

Escolha um layout que corresponda à estrutura do processo:

  • De cima para baixo: Fluxos sequenciais simples
  • Seções da esquerda para a direita: Quando há fases distintas que se transferem umas para as outras
  • Caixas agrupadas: Quando atores possuem diferentes conjuntos de etapas
  • Loops de feedback: Use setas tracejadas que contornam o exterior e retornam

Esboce mentalmente as caixas delimitadoras aproximadas antes de escrever as coordenadas SVG:

  • Dê a cada seção espaço suficiente (tipicamente 400×500px por grupo principal)
  • Deixe lacunas de 40-60px entre elementos para as setas
  • Planeje um tamanho de tela que acomode tudo com margens de 30-50px

Etapa 3: Gerar SVG — A Técnica Central

3.1 Efeito Desenhado à Mão: A Combinação feTurbulence + feDisplacementMap

Este é o coração do visual esboçado. Ele desloca pixels usando ruído Perlin, fazendo com que linhas retas e cantos vivos pareçam desenhados à mão.

<defs>
  <!-- Para formas (caixas, ovais, contêineres grandes) — oscilação moderada -->
  <filter id="sketchy" x="-3%" y="-3%" width="106%" height="106%">
    <feTurbulence type="turbulence" baseFrequency="0.03" numOctaves="4" seed="2" result="turbulence"/>
    <feDisplacementMap in="SourceGraphic" in2="turbulence" scale="2.5"
                       xChannelSelector="R" yChannelSelector="G"/>
  </filter>
</defs>

Importante: NÃO aplique NENHUM filtro a setas/linhas conectoras. O filtro feDisplacementMap — mesmo em escala baixa — faz com que linhas finas se tornem invisíveis ou fragmentadas na maioria dos renderizadores SVG. As setas devem ser desenhadas SEM nenhum atributo de filtro. A sensação de desenho à mão para as setas vem do uso de stroke-width="3" ou mais grosso, que já parece orgânico o suficiente ao lado das formas filtradas.

3.2 Padrões de Hachura

Padrões de linhas diagonais simulam hachura cruzada desenhada à mão:

<pattern id="hatch-azul" width="8" height="8" patternUnits="userSpaceOnUse"
         patternTransform="rotate(-45)">
  <line x1="0" y1="0" x2="0" y2="8" stroke="#a0c4f0" stroke-width="1.5" opacity="0.5"/>
</pattern>

Camada do padrão de hachura com um preenchimento sólido semitransparente para legibilidade:

<!-- Camada de hachura -->
<rect ... fill="url(#hatch-azul)" stroke="#3b82d0" stroke-width="3.5" filter="url(#sketchy)"/>
<!-- Sobreposição de legibilidade -->
<rect ... fill="#dbeafe" opacity="0.25"/>

Crie um padrão de hachura por tema de cor usado no diagrama.

3.3 Fontes de Caligrafia — USE EXATAMENTE ESTAS, SEM SUBSTITUIÇÃO

As fontes devem ser consistentes em todos os diagramas. Use este bloco <style> exato — não use Caveat, Patrick Hand ou qualquer outra fonte. Este é um requisito rigoroso.

Para diagramas contendo texto em chinês:

<style>
  @import url('https://fonts.googleapis.com/css2?family=Ma+Shan+Zheng&amp;family=ZCOOL+KuaiLe&amp;display=swap');
  /* Texto chinês — Ma Shan Zheng, fonte estilo pincel */
  text {
    font-family: 'Ma Shan Zheng', 'ZCOOL KuaiLe', 'STKaiti', 'KaiTi', cursive;
  }
  /* Rótulos em inglês (nomes de código, termos técnicos como /task-add, Backlog, YAML) */
  .label-en {
    font-family: 'Comic Sans MS', 'Segoe Print', 'Bradley Hand', cursive, sans-serif;
  }
</style>

Para diagramas inteiramente em inglês:

<style>
  @import url('https://fonts.googleapis.com/css2?family=Ma+Shan+Zheng&amp;display=swap');
  text {
    font-family: 'Comic Sans MS', 'Segoe Print', 'Bradley Hand', cursive, sans-serif;
  }
</style>

Aplique class="label-en" aos elementos de texto em inglês em diagramas chineses. Nunca use Caveat, Patrick Hand, Indie Flower ou qualquer outra fonte de caligrafia — mantenha Ma Shan Zheng para chinês e Comic Sans MS para inglês.

3.4 Marcadores de Seta

Defina marcadores de seta coloridos que correspondam ao tema de cada seção:

<marker id="seta-azul" viewBox="0 0 12 12" refX="10" refY="6"
        markerWidth="10" markerHeight="10" orient="auto-start-reverse">
  <path d="M 2 3 L 10 6 L 2 9 Z" fill="#3b82d0"/>
</marker>

Use marker-end="url(#seta-azul)" nas linhas conectoras. Para conexões tracejadas (mostrando fluxo indireto/opcional), adicione stroke-dasharray="14 10".

3.5 Vocabulário de Formas

ConceitoForma SVGExemplo
Ator/Papel<ellipse>PM, Usuário, Sistema
Etapa de processo<rect rx="6">/task-add, build step
Contêiner/Fase<rect rx="20"> grande, com hachuraSeção "1. Entrada de Requisitos"
Dados/Saída<path> paralelogramoBacklog, Relatório
Decisão<path> losangoRamificação Sim/Não
Limite externo<rect> com stroke-dasharrayLimite do sistema, loop de feedback

3.6 Temas de Cor

Cada seção/ator principal deve ter sua própria cor. Boas paletas:

  • Azul: stroke="#3b82d0", fill="#dbeafe", text="#1e40af", hachura="#a0c4f0"
  • Laranja/Amarelo: stroke="#d4920a", fill="#fef3c7", text="#92400e", hachura="#f0d080"
  • Verde: stroke="#2d8a4e", fill="#d1fae5", text="#065f46", hachura="#5a9e6f"
  • Roxo: stroke="#7c3aed", fill="#ede9fe", text="#5b21b6", hachura="#b4a0e8"
  • Cinza (para conectores tracejados): stroke="#777"

3.7 Conectando Elementos — SEM FILTRO NAS SETAS

Esta é a seção mais crítica. Setas que quebram ou desaparecem arruínam todo o diagrama.

Regras:

  1. Cada conector <line> ou <path> de seta deve ter stroke-width="3" ou mais grosso
  2. Cada seta deve ter um atributo marker-end="url(#seta-xxx)"
  3. Nunca adicione filter="url(#sketchy)" ou filter="url(#sketchy-line)" a nenhuma seta — filtros tornam linhas finas invisíveis
  4. Deixe uma lacuna de 5-10px entre a borda da forma e o ponto de início/fim da seta para que a ponta da seta seja claramente visível
  5. Setas em L devem terminar no eixo central do alvo — se a forma alvo está centralizada em x=600, o segmento final da seta deve terminar em x=600, não em algum deslocamento. Calcule as coordenadas do centro do alvo a partir de seu cx/cy (para elipses) ou x + largura/2, y (para retângulos)
  6. Rótulos de setas não devem sobrepor a linha da seta — coloque rótulos 15-20px acima ou abaixo do caminho da seta, nunca na mesma coordenada y de uma seta horizontal ou na mesma x de uma vertical
<!-- Seta sólida (fluxo direto) — SEM atributo de filtro -->
<line x1="260" y1="390" x2="260" y2="425"
      stroke="#3b82d0" stroke-width="3"
      marker-end="url(#seta-azul)"/>

<!-- Seta tracejada (fluxo indireto/opcional) — SEM atributo de filtro -->
<line x1="460" y1="440" x2="590" y2="440"
      stroke="#777" stroke-width="3" stroke-dasharray="14 10"
      marker-end="url(#seta-cinza)"/>

<!-- Caminho em L ou curvo — SEM atributo de filtro -->
<path d="M 40 700 L 40 50 L 100 50" fill="none"
      stroke="#2d8a4e" stroke-width="4" stroke-dasharray="16 10"
      marker-end="url(#seta-verde)"/>

Etapa 4: Verificar Setas (Autoverificação)

Após escrever o SVG, você deve verificar cada conexão antes de salvar o arquivo. Esta etapa pega o defeito mais comum e mais prejudicial — setas faltando.

Procedimento:

  1. Listar todas as conexões: Volte à decomposição da Etapa 1 e enumere cada seta que deve existir. Escreva-as como uma lista de verificação:

    Lista de verificação de conexões:
    - [ ] Nó A → Nó B (fazer pedido)
    - [ ] Nó B → Nó C (processar pedido)
    - [ ] Nó C → Nó D (pagamento bem-sucedido)
    ...
    
  2. Para cada conexão, verifique no SVG se há um elemento <line> ou <path> com coordenadas que vão da borda inferior/direita do nó de origem até a borda superior/esquerda do nó de destino, E que tenha um atributo marker-end.

  3. Verifique contaminação por filtro: Pesquise no SVG por qualquer <line ou <path conector que contenha filter=. Se encontrado, remova o atributo filter desse elemento.

  4. Verifique a sanidade das coordenadas: Para cada seta, verifique:

    • O ponto de início (x1,y1) está próximo da borda inferior/direita da forma de origem
    • O ponto de fim (x2,y2) está próximo da borda superior/esquerda da forma de destino
    • Para caminhos em L, o segmento final deve terminar no centro x ou y da forma de destino
    • Os pontos de início e fim são diferentes (não são linhas de comprimento zero)
  5. Verifique o posicionamento dos rótulos: Para cada elemento de texto de rótulo de seta, verifique:

    • O y do rótulo está pelo menos 15px acima ou abaixo da coordenada y da seta (para setas horizontais)
    • O x do rótulo está pelo menos 15px à esquerda ou à direita da coordenada x da seta (para setas verticais)
    • Os rótulos não se sobrepõem a nenhuma caixa de forma

Se alguma conexão estiver faltando, adicione-a antes de salvar.

Etapa 5: Gerar Saída e Iterar

  1. Verifique se o arquivo existe antes de escrever: Antes de salvar, verifique se o arquivo de destino já existe. Se existir, anexe um sufixo de versão para evitar sobrescrita:

    • Primeiro arquivo: fluxograma.svg
    • Se fluxograma.svg existir: salve como fluxograma-v1.svg
    • Se fluxograma-v1.svg também existir: salve como fluxograma-v2.svg
    • Continue incrementando até encontrar um nome de arquivo não utilizado
    • Use ls ou test -f para verificar a existência antes de escrever
  2. Escreva o SVG no caminho de arquivo determinado

  3. Converta SVG para PNG e faça uma autoverificação visual: NÃO abra o arquivo para o usuário ainda. Em vez disso, converta e inspecione primeiro o resultado:

    rsvg-convert entrada.svg -o saida.png
    

    Em seguida, use a ferramenta de Leitura para visualizar a imagem PNG gerada. Inspecione cuidadosamente:

    • Problemas de layout: Os elementos estão sobrepostos? Algum texto está cortado ou transbordando de seu contêiner? Há grandes lacunas vazias ou áreas apertadas?
    • Problemas de setas: Todas as setas estão visíveis? Alguma seta aponta na direção errada, cruza formas ou parece desconectada/quebrada?
    • Legibilidade do texto: O texto é legível e não se sobrepõe a outros elementos?
    • Equilíbrio geral: O diagrama parece bem proporcionado dentro da tela?

    Se QUALQUER problema for encontrado, volte e corrija o SVG, reconverta e reinspecione. Repita até que o diagrama passe na inspeção visual.

  4. Uma vez que o diagrama passe na inspeção, informe ao usuário que os arquivos SVG e PNG estão prontos, e forneça os caminhos dos arquivos. NÃO use open — o usuário pode estar em um servidor remoto.

  5. Esteja pronto para feedback — pedidos comuns incluem:

    • "Essa caixa é muito pequena" → Aumente as dimensões e reposicione
    • "A seta quebrou" → Remova qualquer filtro da seta, aumente o stroke-width
    • "A fonte não parece manuscrita o suficiente" → Verifique a importação do Google Fonts, confira a string exata do font-family
    • "A cor está muito clara/escura" → Ajuste a opacidade e as cores do stroke
    • "Reorganizar layout" → Recalcular coordenadas

Armadilhas Comuns

  • Setas desaparecendo: O problema nº1. NUNCA aplique filter a <line> ou <path> de seta. O filtro de deslocamento torna elementos finos invisíveis. Apenas formas (<rect>, <ellipse>, <path> de contêiner) devem ter filtros.
  • Inconsistência de fonte: Sempre use Ma Shan Zheng para chinês, Comic Sans MS para inglês. Nunca substitua por Caveat, Patrick Hand, Indie Flower, etc.
  • Texto sem aparência manuscrita: O @import do Google Fonts requer acesso à internet para ser carregado corretamente. Se o texto aparecer com uma fonte serifada padrão, verifique a conexão e a string de URL.
  • Proporção e layout incompatíveis: O layout deve ser adaptado à proporção. Diagramas largos precisam de fluxos horizontais; diagramas altos precisam de fluxos verticais.

Habilidades Relacionadas