Relatórios e Análises

O que é: Central de insights.

Visão Geral

Determina a configuração mínima útil de Relatórios e Análises para o negócio em questão e, em seguida, a constrói apenas quando solicitada. A saída padrão é uma recomendação curta, não uma planilha. Artefatos - CSV, SQL DDL, JSON Schema, mapeamento Notion - são produzidos sob demanda, a partir de uma lista de campos para que não se desalinhem.

Camada: Camada 9: Analisar. Encaixa: Estágio de Escala. Código da tabela: n/a.

Quando Usar Esta Habilidade

• construtor de relatórios
• modelo de relatório de análise
• rastreador de relatórios periódicos
• relatórios de insights

Use-a também quando o usuário disser "central de insights" ou descrever o mesmo processo ocorrendo em uma planilha, um documento ou alguém enviando por e-mail.

Não a use para: cálculo de folha de pagamento, declaração de impostos ou aconselhamento jurídico. Esta habilidade produz apenas modelos vazios - ela nunca armazena ou processa dados reais de funcionários ou clientes.

Como Funciona

Siga o contrato de execução compartilhado. As regras específicas do módulo abaixo definem apenas campos de domínio, decisões, cálculos e restrições de segurança.

Etapa 1 - Identificar a intenção

Leia a solicitação e escolha a intenção antes de perguntar qualquer coisa.

• "configurar" ou "construir" ou "criar" -> o usuário quer artefatos; vá para a Etapa 2.
• "nosso processo é ..." ou "está em uma planilha" -> o usuário quer mover um processo existente; capture-o, depois vá para a Etapa 2.
• "isso está certo" ou "revisar" ou "auditar" -> o usuário quer uma verificação, não uma construção; responda com base no que eles compartilham.
• "como eu faço ..." -> pergunta de aconselhamento; responda diretamente e ofereça a construção apenas se ajudar.

Pergunte apenas se este é o fato faltante de maior valor; caso contrário, prossiga sem uma introdução:

P: Quem lê os relatórios que você produz agora?

Etapa 2 - Pergunte apenas o que está faltando

Ignore tudo o que o usuário já respondeu, em qualquer mensagem anterior. Pergunte o restante um de cada vez e pare assim que as respostas restantes não alterarem a saída.

• Leitores - Quem os lê? / Com que frequência? / Mensalmente ou semanalmente?
• Conteúdo - Quais números? / Comparações incluídas? / Alguma narrativa?
• Dados - Fontes disponíveis? / Quem os prepara? / Quanto tempo leva?
• Processo atual - Como é produzido agora? / Esforço manual? / É confiável?
• Resultado - O que você precisa? / Um conjunto de relatórios, um modelo ou os dados subjacentes?

Nunca invente uma resposta. Se o usuário não souber, registre como desconhecido e continue.

Etapa 3 - Mantenha o contexto interno

Mantenha as respostas nesta forma. Ela permanece interna - não é mostrada ao usuário a menos que ele peça, e nunca carrega um valor que o usuário não forneceu.

module: reports-analytics
intent: null            # setup | advice | review | fix | build | convert | export
scale: null             # Starter | Growth | Scale, only if the answer changes it
areas:
  "Readers": null
  "Content": null
  "Data": null
  "Current process": null
  "Outcome": null
requested_outputs: []   # csv | sql | json | notion | xlsx - requested formats only
confirmed_facts: []     # only what the user actually said
open_questions: []      # the unanswered ones, in the order worth asking

Etapa 4 - Recomende o menor fluxo de trabalho

Se um artefato foi solicitado, construa-o após resolver os fatos essenciais faltantes. Caso contrário, dê uma recomendação curta e ofereça o artefato relevante.

Abordagem recomendada: Construir um pacote mensal fixo com um pequeno conjunto de números e um comentário por número, e parar de produzir relatórios que ninguém lê.

Por que este: O esforço de relatórios vai para a formatação, não para a análise. Um modelo fixo mais um comentário por métrica é a versão mínima útil.

Fluxo de trabalho: Dados coletados → Métrica calculada → Comentário escrito → Circulado → Ação registrada

Etapa 5 - Construa apenas sob demanda

Assim que o usuário solicitar, derive os campos do contexto confirmado e emita os artefatos solicitados. Para texto legível por máquina, mantenha a prosa fora dos dados; para arquivos, forneça um link utilizável. Relate falhas de validação de material ou limitações separadamente.

Uma saída Notion selecionada é renderizada por notion-manual-import, portanto, direcione a etapa Notion para lá. Quando o usuário selecionar Notion, entregue essa etapa para @notion-manual-import: ela contém o CSV, o mapeamento de propriedades, as etapas de importação e a lista de verificação de verificação, e renderiza a Referência de Campo abaixo em vez de definir uma tabela própria. Não repita o mapeamento aqui e não improvise as etapas de importação. Saídas manuais de CSV e mapeamento não precisam de conexão. Para alterações solicitadas no espaço de trabalho, siga o contrato compartilhado: verifique o real

…