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.
| Etapa | Descrição resumida |
|---|---|
| 0 Domain Detect | Lê o resolver → roteia para o pacote de domínio (ou genérico) |
| 1 Profile | Agente 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 Scan | Escrita em tempo real da varredura de sinais (anomalias / mudanças significativas / desvios de índice em relação à base) |
| 3 Clarify | Só pergunta quando ambiguidades ou limitações de dados bloqueiam a solicitação (aqui as lacunas são apresentadas ao usuário) |
| 4 Frame | Usa o framework.md do domínio para montar uma árvore de issues MECE |
| 5 Hypothesize | Hipóteses falsificáveis, associadas a alavancas de domínio |
| 6 Verify | Escreve verificação pandas em tempo real → verdicts.json |
| 7 Decompose | Escreve decomposição em tempo real → drivers.json |
| 8 Synthesize | Saí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-up | Extensã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-referencedo 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)
- Leia
references/resolver.md(mecanismo de pontuação neutro de domínio) e enumere cadadomains/<slug>/triggers.md(blocos de gatilho de cada domínio). - 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. - Roteamento: ≥2 sinais apontando para o mesmo domínio → roteamento silencioso; ambiguidade → siga
clarification-protocol.mdpara o usuário escolher; nenhuma correspondência → modo genérico e informe. - Leia o
domains/<slug>/README.mddo domínio roteado; os demais slots são carregados conforme a tabela de carga do 9-step na etapa correspondente. - 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)
- 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.
- Cada número referencia um
verdict_id, rastreável atéoutputs/verdicts.json. - 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.
- Estado persistente. Antes de cada rodada, leia; antes de responder, atualize
outputs/analysis_state.json. - 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.mdStep 6 (portão de cobertura). - 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 pelodeck_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 emreferences/9-step-framework.mdStep 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ãodeck_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.mde consideravam Step 8 concluído, com o deck ausente silenciosamente (causa raiz: não carregavam os slotsinsight-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 deinsight_report.mdem 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.*