Diagramas (Diagramas)
Projete, crie, revise e converta diagramas mantendo o argumento visual e a fonte nativa independentemente corretos.
O contrato de integração legível por máquina lista os pré-requisitos externos.
Resolver duas decisões
Primeiro, escolha a visão que expressa o relacionamento: fluxograma, sequência, estado, arquitetura, modelo de dados, hierarquia, linha do tempo, comparação ou outra visão suportada. Em seguida, escolha o formato de entrega. Não deixe que um formato de arquivo familiar decida o tipo de diagrama.
Um formato explícito vence quando consegue expressar a estrutura necessária. Se criar uma limitação material, explique a limitação e ofereça uma alternativa sem alterar silenciosamente o entregável.
Use esta matriz quando o formato estiver em aberto:
| Restrição | Excalidraw | Mermaid | draw.io |
|---|---|---|---|
| Controle manual de coordenadas | Forte | Fraco; layout é automático | Forte |
| Edição visual colaborativa | Forte no Excalidraw | Depende do hospedeiro | Forte no diagrams.net |
| Diff textual e revisão de código | Ruim | Forte | Moderado com XML descompactado |
| Layout automático | Manual primeiro | Forte | Disponível, mas geometria manual permanece explícita |
| Composição espacial livre | Forte | Limitada | Forte |
| Páginas, camadas, contêineres, bibliotecas de formas | Limitado | Limitado e dependente do renderizador | Forte |
| Renderização direta em Markdown/chat | Raro | Forte quando suportado | Raro |
| Editabilidade nativa após transferência | .excalidraw | Fonte Mermaid em editor compatível | XML .drawio |
| Validação e renderização confiáveis | Precisa de verificador mais renderizador fiel | Precisa do parser alvo mais renderizador | Precisa de verificações XML mais editor/exportador compatível |
Prefira o formato cujo editor nativo, validador e renderizador estão disponíveis no ambiente de entrega. Se nenhum puder fornecer prova visual, produza a fonte nativa solicitada apenas quando ainda for útil e rotule o resultado como DEGRADED.
Assuma o controle do argumento visual
Defina uma questão, público, viewport de entrega, ponto de entrada e direção de leitura dominante. Preserve fatos exatos e identificadores enquanto encurta rótulos explicativos. Modele nós semânticos, limites e relacionamentos antes da sintaxe ou das coordenadas.
Leia o método de design compartilhado antes de criar ou revisar materialmente um diagrama. Ele é dono da topologia, hierarquia, densidade, agrupamento, limites, roteamento, uso semântico de forma/cor/linha, critérios de divisão e aceitação visual.
Use um adaptador de formato
- Para JSON
.excalidrawnativo, leia o adaptador Excalidraw. Execute seu verificador agrupado e inspecione uma renderização fiel. - Para fonte Mermaid ou bloco Mermaid no chat, leia o adaptador Mermaid. Faça o parse e renderize com o alvo real ou uma ferramenta existente compatível.
- Para XML
.drawionativo, leia o adaptador draw.io. Valide a estrutura XML, abra ou exporte com uma ferramenta diagrams.net compatível e inspecione o resultado.
Os adaptadores de formato detêm a serialização, escapamento, identificadores, ligações, geometria, temas, páginas, camadas e limitações específicas do renderizador. Não copie sua mecânica volátil para este núcleo.
Preserve a fonte nativa
Para um novo entregável de caminho nomeado, o caminho solicitado torna-se canônico quando escrito pela primeira vez. Para uma revisão, a fonte existente permanece canônica enquanto as alterações vivem em um candidato. Editores e renderizadores consomem esses artefatos; uma exportação para outro lugar nunca substitui implicitamente a fonte canônica.
Um candidato de revisão substitui a fonte existente apenas quando atende ao portão de conclusão. Caso contrário, reporte DEGRADED, deixe a fonte existente inalterada e identifique o candidato como inacabado.
Converter e revisar
Através de conversões, preserve a identidade semântica: significado do nó, direção do relacionamento, sequência, contenção, limites, cardinalidade e tokens técnicos exatos. Preserve páginas, camadas e identidade do contêiner quando tanto a origem quanto o destino as suportarem. Declare perdas como alterações de layout automático, bibliotecas de formas não suportadas ou estilo achatado; nunca prometa paridade de pixels.
Para trabalho apenas de revisão, inspecione e reporte sem reescrever. Verifique a estrutura nativa separadamente da composição renderizada: um parse bem-sucedido não prova legibilidade, e uma imagem plausível não prova editabilidade.
Limite de gatilho
Esta skill possui chamadas explícitas x9-diagrams, seleção de formato, conversão entre formatos, o método visual compartilhado e verificação estrutural mais visual combinada. Uma solicitação limitada à sintaxe Mermaid comum pode permanecer com uma skill mermaid-diagrams especializada instalada. Esta skill permanece autocontida para usuários que não possuem essa skill de terceiros.
Quando a propriedade do gatilho for ambígua, use x9-diagrams apenas se a tarefa precisar de seu contrato mais amplo de decisão ou verificação. Não invoque ambas as skills apenas porque Mermaid aparece na solicitação.
Portão de conclusão
Corresponda a evidência de conclusão à ação solicitada:
- Seleção de formato: nomeie a visão e o formato de entrega, conecte a escolha às restrições do usuário, declare limitações materiais e identifique se um validador, renderizador ou editor compatível está disponível.
- Criação ou revisão material: a visão escolhida responde à questão declarada; a fonte nativa faz parse ou abre e permanece editável; o agente não acionou um seletor de arquivo ou diretório nativo que não pôde concluir por conta própria; o layout pós-carregamento específico do formato está estável quando aplicável; um renderizador ou editor compatível produziu a visão real a partir da fonte canônica final após sua última mutação material; e essa visão foi inspecionada em seu modo de entrega declarado quanto à legibilidade, hierarquia, cruzamentos, recorte e estrutura enganosa.
- Conversão: atenda à evidência de criação e confirme que semânticas importantes sobreviveram; declare qualquer perda em layout, estilo, páginas, camadas, contêineres ou notação.
- Revisão apenas: distinga achados de estrutura nativa de achados de composição renderizada e cite a evidência inspecionada sem reescrever o artefato.
Se qualquer evidência necessária para a ação ativa não puder ser obtida, reporte DEGRADED com a verificação exata faltando, validador, renderizador, editor ou artefato de origem. Os testes de regressão do verificador Excalidraw estão em scripts/test_check_scene.py.