visualização-de-gráficos

Habilidade de Visualização de Gráficos

Esta habilidade fornece um fluxo de trabalho abrangente para transformar dados em gráficos visuais. Ela lida com seleção de gráficos, extração de parâmetros e geração de imagens.

Fluxo de Trabalho

Para visualizar dados, siga estas etapas:

1. Seleção Inteligente de Gráficos

Analise as características dos dados do usuário para determinar o tipo de gráfico mais apropriado. Use as seguintes diretrizes (e consulte references/ para especificações detalhadas):

• Série Temporal: Use generate_line_chart (tendências) ou generate_area_chart (tendências acumuladas). Use generate_dual_axes_chart para duas escalas diferentes.
• Comparações: Use generate_bar_chart (categórico) ou generate_column_chart. Use generate_histogram_chart para distribuições de frequência.
• Parte-Todo: Use generate_pie_chart ou generate_treemap_chart (hierárquico).
• Relações e Fluxo: Use generate_scatter_chart (correlação), generate_sankey_chart (fluxo) ou generate_venn_chart (sobreposição).
• Mapas: Use generate_district_map (regiões), generate_pin_map (pontos) ou generate_path_map (rotas).
• Hierarquias e Árvores: Use generate_organization_chart ou generate_mind_map.
• Especializados:
  • generate_radar_chart: Comparação multidimensional.
  • generate_funnel_chart: Etapas de processo.
  • generate_liquid_chart: Porcentagem/Progresso.
  • generate_word_cloud_chart: Frequência de texto.
  • generate_boxplot_chart ou generate_violin_chart: Distribuição estatística.
  • generate_network_graph: Relações complexas de nós e arestas.
  • generate_fishbone_diagram: Análise de causa-efeito.
  • generate_flow_diagram: Fluxo de processo.
  • generate_spreadsheet: Dados tabulares ou tabelas dinâmicas para exibição estruturada de dados e tabulação cruzada.

2. Extração de Parâmetros

Depois que um tipo de gráfico é selecionado, leia o arquivo correspondente no diretório references/ (por exemplo, references/generate_line_chart.md) para identificar os campos obrigatórios e opcionais. Extraia os dados da entrada do usuário e mapeie-os para o formato esperado de args.

3. Geração do Gráfico

Invoque o script scripts/generate.js com um payload JSON.

Formato do Payload:

{
  "tool": "generate_chart_type_name",
  "args": {
    "data": [...],
    "title": "...",
    "theme": "...",
    "style": { ... }
  }
}

Comando de Execução:

node ./scripts/generate.js '<payload_json>'

4. Retorno do Resultado

O script irá gerar a URL da imagem do gráfico. Retorne o seguinte para o usuário:

• A URL da imagem.
• Os args completos (especificação) usados na geração.

Material de Referência

Especificações detalhadas para cada tipo de gráfico estão localizadas no diretório references/. Consulte esses arquivos para garantir que os args passados para o script correspondam ao esquema esperado.

Licença

Este SKILL.md é fornecido por antvis/chart-visualization-skills. Licenciado sob a Licença MIT.