yokingma/flow-diagram

Diagrama de Fluxo

Flow Diagram é a skill de autoria para diagramas executáveis de sistemas e processos: crie uma vez, depois reproduza, incorpore, inspecione e exporte o resultado.

Transforme descrições e material de origem em explicações visuais: diagramas estáticos ou animados que tornam estruturas, relacionamentos e processos claros. O objetivo é preservar o significado da fonte e ajudar os leitores a entender como as coisas são organizadas, conectadas e mudam ao longo do tempo.

Escolha a tarefa

Esta skill produz ativos de diagrama; arquivos PPTX e formas nativas do PowerPoint estão fora de seu escopo.

Identifique o tipo de tarefa, a entrada a ser usada e onde iniciar ou retomar o processo.

Solicitação	Ponto de partida
Novo diagrama ou importação JSON que será criado ou revisado	Complete a verificação prévia de preferências, depois siga todas as cinco etapas. Preserve bytes importados inalterados quando necessário.
Importação JSON inalterada para exportação ou inspeção	Use o ponto de entrada de exportação ou diagnóstico; pule a verificação prévia de preferências e mantenha o design de entrada.
Revisar um diagrama finalizado	Leia o diagrama existente e o relatório final. Estabeleça as alterações e o escopo solicitados, complete a verificação prévia de preferências, depois siga o processo de cinco etapas, reutilizando decisões de design que permanecem válidas. Mantenha os formatos solicitados, a menos que o usuário os altere.
Adicionar apenas formatos de exportação	Entre na etapa 3 com o diagrama existente inalterado. Pule alterações de rascunho, estilo, medição e layout, depois inspecione e finalize os arquivos solicitados.
Continuar uma tarefa inacabada	Leia os registros da tarefa e selecione a revisão salva para continuar. Retome nas etapas inacabadas ou naquelas afetadas por alterações.
Apenas validação ou diagnóstico	Use validate para verificações estruturais. Se o diagnóstico visual for solicitado, siga os fluxos de trabalho de inspeção aplicáveis na etapa 4. Relate as verificações realizadas, seus limites e problemas descobertos, depois pare.

Para solicitações independentes de salvar, alterar ou redefinir, siga as preferências do projeto e relate a operação sem criar um diagrama.

Para importações, revisões ou exportações de diagramas existentes, leia seleção de entrada e pai. Antes de criar arquivos de tarefa, leia requisitos do espaço de trabalho da tarefa; para comandos de validação e estados de relatório, leia contratos de tempo de execução e resultado.

Prossiga quando a entrada, as alterações autorizadas e o ponto de entrada do processo estiverem claros.

Processo

0. Inicializar preferências de design

Para rascunhos novos e revisados, siga as preferências do projeto antes da etapa 1. Complete sua verificação prévia resolvendo escolhas visuais relevantes e registrando suas fontes; finalize qualquer salvamento solicitado ou divulgue sua falha. Solicitações independentes de gerenciamento de preferências usam essa referência e param após relatar a operação. Tarefas de exportação, validação e diagnóstico puras mantêm seus pontos de entrada existentes. Retome tarefas inacabadas com suas decisões registradas, revisitando a verificação prévia apenas quando uma escolha relevante mudar.

1. Definir o objetivo da explicação

Comece com a pergunta do leitor: o que o leitor deve entender após visualizar o diagrama? Use essa pergunta para orientar decisões posteriores de conteúdo, layout e animação.

• Defina a pergunta. Identifique o assunto e o que o leitor deve entender a partir da solicitação do usuário.

• Estabeleça os fatos. Leia as fontes designadas pelo usuário ou o diagrama existente dentro do escopo autorizado. Identifique objetos, relacionamentos, processos e mudanças de estado relevantes. Distinga fatos conhecidos de informações que precisam de esclarecimento e registre as fontes por meio de metadados de fonte.

  Para investigações amplas, como explorar um repositório de código, crie um subagente para investigar as partes relevantes para a pergunta do leitor. Dê ao subagente a pergunta e o escopo da fonte autorizada. Peça objetos, relacionamentos, processos e mudanças de estado relevantes, com locais de origem e perguntas não resolvidas. Use essas descobertas para estabelecer os fatos necessários para a explicação.

  Para alguns artigos, um pequeno conjunto de materiais de referência ou uma solicitação curta como "Explique o fluxo de trabalho RAG com um fluxograma", estabeleça os fatos na sessão atual.

• Registre os requisitos. Capture o público, o contexto de uso e os requisitos de entrega já especificados pelo usuário. Siga o contexto de entrega ausente para reutilizar escolhas conhecidas, coletar lacunas relevantes uma vez e registrar suposições adotadas antes de escolher a geometria.

Prossiga quando puder declarar a pergunta do leitor em uma frase e identificar os fatos que suportam sua resposta. Esclareça lacunas de informação que mudariam o significado do diagrama antes de rascunhar. Se o SDK não puder expressar a solicitação fielmente, explique o limite e aguarde a escolha do usuário.

2. Projetar a explicação visual

Escolha como apresentar o assunto para que o leitor possa responder à pergunta definida na etapa 1.

Para rascunhos novos ou revisados, leia os contextos de entrega antes de escolher a tela e a densidade, inclusive quando o propósito for desconhecido. Use a tabela de seleção baseada na pergunta do leitor para inventários de capacidade, responsabilidades, status de recursos, solicitações e respostas, transições de estado, processamento de dados ou arquitetura.

• Selecione o conteúdo. Escolha os objetos, relacionamentos, processos e estados necessários para a explicação. Antes de omitir ou agregar conteúdo ou decidir como apresentar informações de fonte desconhecida, leia fidelidade da fonte e escolhas de informação. Preserve o significado da fonte nessas escolhas.
• Aloque o conteúdo à sua superfície. Antes da geometria do diagrama, siga a alocação de conteúdo para atribuir introduções de página, rótulos vinculados ao diagrama, legendas e prosa de suporte. Registre a alocação e o contexto exigido por cada formato solicitado.
• Organize a estrutura. Defina grupos, hierarquia e ordem de leitura para que o leitor possa identificar os pontos principais e seguir seus relacionamentos.
• Defina a direção visual. Siga design visual para selecionar uma direção para o contexto de uso. Para estruturas em camadas com barra lateral, processos com ramificações ou retornos, ou cartões repetidos com conteúdo mais longo, selecione uma receita de composição aplicável. Registre as escolhas concretas necessárias para a produção.
• Escolha diagramas estáticos ou animação. Use layout estático para explicar estruturas e relacionamentos. Para animação, distinga fluxo de relacionamento persistente, atenção e mudança em etapas; uma solicitação de linhas fluidas pode manter todo o diagrama visível.
• Planeje a narrativa da animação. Ao usar animação, siga o ritmo de animação e continuidade visual para definir o objetivo de explicação de cada etapa, mudanças de estado, transições e pausas de leitura.

Prossiga quando o plano registrar o conteúdo selecionado, suas superfícies de transporte, grupos, ordem de leitura, escolhas visuais e apresentação estática ou animada. Para animação, inclua o plano de etapas.

3. Criar o diagrama

Implemente o design da etapa 2 e gere os artefatos necessários para inspeção na etapa 4.

Use Node 20+ e npm. Execute node <skill-directory>/scripts/flowsvg.mjs do diretório de trabalho escolhido pelo usuário, com caminhos entre aspas quando necessário. Resolva ferramentas e recursos de tarefa dentro desta skill instalada. A CLI prepara seu próprio tempo de execução SDK fixo sem alterar dependências de aplicação.

• Leia a orientação de autoria relevante. Para rascunhos novos ou revisados, leia o modelo de documento e orientação de layout, e implemente as receitas de design selecionadas. Antes de organizar a geometria, verifique as armadilhas de renderização para caminhos curtos com rótulos longos, barras laterais, texto sem borda, cartões estreitos ou riscos de quebra em qualquer idioma, alinhamento óptico de rótulos curtos, bordas de leitura compartilhadas ou tamanhos de conteúdo alterados. Para animação, leia também cenas, estado herdado e temporização. Para arquivos SVG, PNG ou GIF solicitados, leia opções e limites de exportação.
• Construa o documento do diagrama. Para rascunhos novos ou revisados, implemente os objetos, grupos, conexões, texto e estágios de animação planejados. Preserve o idioma de origem e a direção visual selecionada. Para um novo diagrama sem direção especificada, comece com um tema claro e grupos arredondados. Meça o texto no rascunho completo e siga o fluxo de trabalho do plano de layout quando a geometria repetida precisar de um plano. Compare cada objeto, direção de relacionamento, limite de pai e mudança de estado com as fontes. Salve alterações autorizadas em um novo rascunho do espaço de trabalho; para uma importação ou exportação inalterada, use os bytes de entrada selecionados diretamente.
• Valide e corrija. Use validate somente leitura durante a iteração e leia cada diagnóstico. Ele retorna identidade de entrada exata e verificações finitas sem criar uma revisão do diagrama; mantenha o rascunho de trabalho. Aplique correções dentro da autorização atual, seguindo decisões de diagnóstico e revisão. Esclareça correções que mudariam o significado da explicação com o usuário.
• Componha a página HTML. Para explicações HTML novas ou revisadas, escreva HTML/CSS de página para o conteúdo alocado fora do diagrama e submeta-o por meio de páginas HTML editáveis. Para um resultado existente, siga a continuação de página para preservar seu design e sincronizar explicitamente as alterações pretendidas do diagrama. Reutilize o iniciador instalado para novas páginas quando útil; preserve a região do player gerenciada e mantenha a página completa no espaço de trabalho da tarefa.
• Gere artefatos de inspeção. Antes da captura do navegador ou da escolha de uma contagem de amostras de visualização, leia preparação e amostragem do navegador. Use author para produzir o HTML offline necessário, visualizações necessárias e arquivos de exportação solicitados. Use author --browser none quando apenas HTML intermediário for necessário. Para vários estados estáticos nomeados, siga exportações em lote nomeadas; confirme os tempos selecionados a partir dos beats compilados reais com o usuário antes de vincular o manifesto. Siga os contratos de tempo de execução e resultado para configuração, compatibilidade SDK e campos de relatório; use CLI --help para opções de comando.

Prossiga quando o rascunho implementar o plano, ou uma entrada inalterada for preservada, erros de bloqueio forem resolvidos, diagnósticos restantes tiverem decisões de tratamento registradas e todos os arquivos necessários para inspeção estiverem completos. Em caso de falha de exportação, siga as regras de recuperação abaixo e relate arquivos concluídos e não concluídos separadamente.

4. Inspecione o resultado

Para SVG/PNG entregue, siga evidência de artefato sob demanda: execute evidence contra o sujeito salvo explícito, depois visualize e revise independentemente suas imagens. Condições válidas existentes são reutilizadas; novas condições permanecem não visualizadas até inspeção.

Visualize o diagrama gerado e confirme que ele explica o assunto de forma precisa e clara.

• Verifique a precisão semântica. Compare objetos, direções de relacionamento, limites de grupo e mudanças de estado com as fontes. Confirme que omissões e agregação preservam o significado da fonte.
• Verifique a legibilidade visual. Visualize as imagens renderizadas reais no tamanho de exibição pretendido. Inspecione texto, espaçamento, oclusão e ordem de leitura. Trace cada conexão relevante de sua fonte através de curvas e cruzamentos até sua ponta de seta; verifique portas, rótulos e folga de nós não relacionados.
• Avalie o design visual. Siga a inspeção de design visual para identificar defeitos visíveis e registrar observações para o julgamento final de design do usuário.
• Verifique a explicação da animação. Para animação, inspecione o estado inicial, mudanças principais e estado final em relação ao plano de etapas. Siga a inspeção de visualização para estados amostrados. Use a reprodução real ao avaliar o ritmo; relate a inspeção apenas por amostra como limitada aos estados visualizados.
• Verifique os arquivos entregues. Faça a ferramenta abrir o HTML offline salvo real e verifique seu estado de pausa inicial, controles, solicitações offline e estados de reprodução relevantes. Visualize suas imagens capturadas por meio do fluxo de trabalho de inspeção HTML. Inspecione os arquivos de exportação solicitados conforme entregues; use inspeção de artefato de tamanho alvo para arquivos SVG/PNG finais.

Antes de enviar revisões, leia os contratos completos de entrada de revisão e fluxo de trabalho de modelo. Gere um formulário não visualizado com review-template a partir do sujeito explícito do diagrama e, para evidência formal separada, --evidence-from, depois use review independente para observações de HTML, visualização e SVG/PNG formais e registre os IDs, hashes, observações e problemas apenas para imagens realmente visualizadas. O envio repetido de revisão não requer outra versão do diagrama. Quando um navegador ou visualizador de imagens não estiver disponível, registre as verificações não realizadas e seu impacto explicitamente.

Para problemas descobertos, retorne à etapa 3 para aplicar correções autorizadas, regenerar os artefatos e inspecionar os arquivos afetados e estados novamente. Siga as decisões de diagnóstico e revisão ao registrar problemas ou esclarecer medições.

[... truncado para tradução]

5. Finalizar e entregar

Confira os arquivos finais com o usuário, documente o resultado e arquive o espaço de trabalho da tarefa.

• Confirme a entrega. Apresente os artefatos concluídos com uma breve declaração do que foi feito, o que o diagrama explica e onde os arquivos estão localizados. Para alterações solicitadas que não foram totalmente implementadas, relate o estado e os motivos.
• Arquive o espaço de trabalho da tarefa. Siga os procedimentos de arquivamento do espaço de trabalho para preservar o diagrama e os artefatos para reprodução futura, inspeção e continuação.
• Atualize as preferências do projeto. Se novas decisões de design foram tomadas ou preferências existentes foram alteradas, registre-as conforme as preferências do projeto.

Prossiga quando todos os artefatos solicitados estiverem concluídos e entregues, ou quando o estado de arquivamento e as alterações incompletas forem registrados.

Referências

Consulte os arquivos nas pastas references/ para obter orientação detalhada sobre:

• Preferências de design do projeto
• Contextos de entrega e alocação de conteúdo
• Modelo de documento e layout estático
• Design visual e receitas de composição
• Animação e temporização
• Diagnóstico e revisão
• Opções de exportação
• Evidência de artefato e inspeção
• Contratos de ferramenta e resultados