CommunityPesquisa e Análise de Dadosgithub.com

seacen/data-analyst-sz

Um analista de dados sênior treinado, disponível como skill sob demanda — aplica um framework profissional de 9 etapas em qualquer dado estruturado, com cada número rastreável.

O que é data-analyst-sz?

Esta skill transforma um analista de dados sênior em um recurso sob demanda para análise de dados estruturados. Ela opera com um framework **0+9** universal, composto por uma etapa inicial de detecção de domínio (Step 0) e nove etapas analíticas (Steps 1–9). O fluxo é totalmente orientado por instruções, sem scripts pré-definidos: o agente escreve e executa código pandas sob demanda para perfilamento, varredura de sinais, verificação de hipóteses e decomposição, garantindo que cada número seja rastreável a um veredito em `verdicts.json`. A skill é neutra em relação a domínios: todo conhecimento específico é encapsulado em **pacotes de domínio** (`domains/<slug>/`), e o roteamento é feito automaticamente pelo Step 0 com base em sinais dos dados e da entrada do usuário. A entrega padrão para qualquer solicitação estruturada é um **HTML deck** (`insight_deck.html`) e um **relatório Markdown** (`insight_report.md`), ambos passando por uma auditoria de integridade, cobertura e qualidade. A skill suporta múltiplas plataformas de agentes (Claude Code, Cursor, Codex, etc.) e é projetada para ser extensível: novos domínios podem ser adicionados simplesmente preenchendo os slots de um pacote de domínio, sem modificar o núcleo da skill.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add seacen/data-analyst-sz

Installed? Explore more Pesquisa e Análise de Dados skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Perguntar na sua IA favorita

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

Documentação

Skill de Análise de Dados

Análise de dados estruturados com IA nativa: um workflow 0+9 universal + pacotes de domínio plugáveis. Este arquivo é a entrada (detecção de domínio + regras críticas + ponteiros); os detalhes são carregados sob demanda de references/ e do pacote de domínio selecionado. Esta Skill mantém-se neutra em relação a domínios — qualquer conhecimento de domínio está em domains/<nome>/, este arquivo não contém nomes de domínio específicos.

Como funciona — workflow 0+9

A detecção de domínio do Step 0 está neste arquivo; a implementação dos Steps 1–9, o que carregar em cada etapa e o que produzir, está toda em references/9-step-framework.md (contém a única tabela de carga por etapa autoritativa). Qualquer análise começa carregando esse arquivo.

EtapaDescrição resumida
0 Domain DetectLê o resolver → roteia para o pacote de domínio (ou genérico)
1 ProfileAgente escreve o perfilamento em tempo real: colunas → papéis dos campos, determinação de período/snapshot, cálculo de lacunas de dados
2 Signal ScanEscrita em tempo real da varredura de sinais (anomalias / mudanças significativas / desvios de índice em relação à base)
3 ClarifySó pergunta quando ambiguidades ou limitações de dados bloqueiam a solicitação (aqui as lacunas são apresentadas ao usuário)
4 FrameUsa o framework.md do domínio para montar uma árvore de issues MECE
5 HypothesizeHipóteses falsificáveis, associadas a alavancas de domínio
6 VerifyEscreve verificação pandas em tempo real → verdicts.json
7 DecomposeEscreve decomposição em tempo real → drivers.json
8 SynthesizeSaída Pyramid + extensão de insights de domínio; padrão é dois artefatos paralelos: insight_deck.html (HTML deck) + insight_report.md (espelho 1:1), com validação pelo terceiro portão deck_audit (Quick/follow-up podem dispensar o deck)
9 Follow-upExtensão da árvore de issues para responder perguntas subsequentes

Totalmente baseado em instruções, sem scripts pré-definidos: o código dos Steps 1/2/6/7 é escrito e executado pelo agente em tempo real — mas antes de escrever, ele lê os dados reais + o data-spec / glossary / computation-reference do domínio selecionado, entende os campos e períodos específicos daqueles dados e então gera o código conforme as instruções. Não pressupõe nomes de campos ou termos de período (LY/TY/MAT não são universais). O mapeamento dos papéis dos campos é julgamento semântico da IA (lê data-spec §1.0).

Step 0 — Detecção de Domínio (Decisão de Entrada)

  1. Leia references/resolver.md (mecanismo de pontuação neutro de domínio) e enumere cada domains/<slug>/triggers.md (blocos de gatilho de cada domínio).
  2. Pontue cada domínio com base em: redação do usuário / colunas dos dados (após Step 1) / arquivo de dica do projeto ./.data-analysis-domain.
  3. Roteamento: ≥2 sinais apontando para o mesmo domínio → roteamento silencioso; ambiguidade → siga clarification-protocol.md para o usuário escolher; nenhuma correspondência → modo genérico e informe.
  4. Leia o domains/<slug>/README.md do domínio roteado; os demais slots são carregados conforme a tabela de carga do 9-step na etapa correspondente.
  5. Registre em outputs/analysis_state.json::domain_selected; reutilizado em rodadas subsequentes, sem re-verificação.

Regras críticas (inquebráveis; detalhes em references/anti-hallucination.md)

  1. LLM nunca calcula números. Agregações / participações / índices / decomposições → sempre o agente escreve e executa pandas; nenhum número na saída é derivado do LLM.
  2. Cada número referencia um verdict_id, rastreável até outputs/verdicts.json.
  3. Primeiro detecte, depois esclareça. Antes de completar os Steps 0–2, não pergunte "o que analisar?"; por padrão, vá direto ao ponto; é possível ajustar depois.
  4. Estado persistente. Antes de cada rodada, leia; antes de responder, atualize outputs/analysis_state.json.
  5. Cobertura total: nenhuma folha pode ser descartada silenciosamente. Cada folha viável da árvore de issues (Step 4) deve, no Step 6, ser answered ou explicitamente ignorada (com justificativa); "falta de tempo" não é motivo válido. O critic do Step 8 verifica a cobertura. Detalhes em references/9-step-framework.md Step 6 (portão de cobertura).
  6. Entrega padrão = deck + relatório, não diálogo embutido. Qualquer solicitação de análise de dados estruturados segue por padrão o workflow 0+9 completo e produz, no Step 8, outputs/insight_deck.html + outputs/insight_report.md (salvos em disco, validados pelo deck_audit) — esta é a entrega padrão, não um "plus opcional". Mostrar algumas tabelas/linhas de texto no diálogo ≠ análise completa (isso significa que não chegou ao Step 8). Uma pergunta de análise focada/específica (ex.: "veja a distribuição de X", "quem ganhou em Y período") não é uma "solicitação leve" — ela segue o fluxo completo e gera o deck. As únicas duas isenções: ① Step 9 follow-up (pergunta de acompanhamento a uma análise já concluída); ② Usuário explicitamente pede "rápido/curto/resposta verbal". Mesmo isentas, a resposta deve declarar explicitamente "rodada leve, sem deck". Detalhes em references/9-step-framework.md Step 8 + references/insight-templates.md.

Pacotes de domínio

Um pacote = um conjunto de slots .md com nomes genéricos: triggers (bloco de gatilho da detecção de domínio Step 0) · glossary · data-spec · framework · computation-reference · insight-extensions · context-notes · clarification-extensions · business-rules.md. Protocolo dos slots, quem preenche, três tipos de conteúdo, fluxo de manutenção → references/domain-pack-protocol.md (única fonte autoritativa). Para gerar/manter um pacote → skill domain-pack-builder.

Adicionar um novo domínio

Crie domains/<novo>/ e preencha os slots (incluindo triggers.md com o bloco de gatilho). Este Skill e outros arquivos genéricos não são modificados — o mecanismo resolver enumera automaticamente o triggers.md do novo pacote.


  • v0.9 (2026-06-09 Simetrização do portão do deck): Eleva o HTML deck de "padrão embutido no slot do Step 8" para condição de saída obrigatória no nível do framework — a tabela de carga do Step 8, saídas, Critic e condição de saída são unificadas para "padrão é dois artefatos paralelos: insight_deck.html + insight_report.md (espelho 1:1), validados pelo terceiro portão deck_audit.py (no mesmo nível de data_integrity + coverage)"; Quick/Step9-follow-up podem dispensar o deck, mas devem declarar explicitamente. Correção de ponto cego identificado em campo: perguntas focadas geravam apenas relatório .md e consideravam Step 8 concluído, com o deck ausente silenciosamente (causa raiz: não carregavam os slots insight-templates.md+insight-extensions.md, portanto a seção Outputs agora inclui o lembrete "primeiro leia os dois slots"). Mantém a camada genérica neutra (deck/audit são conceitos genéricos; design system / palavras proibidas / arquivo de fonte / logo-id são todos lidos do domínio em tempo de execução).*
  • v0.8 (2026-05-30 Reforço de robustez): Adiciona portão de cobertura (regra crítica 5, folhas não podem ser descartadas silenciosamente); verificação de integridade dos dados no Step 2 (soma de participações / linhas de agregação incorporadas); regra de ferro para granularidade de decomposição no Step 7; método para domar cabeçalhos multinível; scripts unificados em outputs/scripts/ + convenção de nomenclatura + reutilização de fingerprint de schema (mesmo schema não reescreve loaders); Step 8 impõe gravação de insight_report.md em disco. Remove vestígios específicos de domínio da camada genérica (restaura a neutralidade). v0.7: Totalmente baseado em instruções (remove scripts pré-definidos). v0.6: Normalização do Skill Creator.*

Habilidades Relacionadas