ViksyaHQ/ai-readiness-assessment

Avaliação de Prontidão para IA — Skill Complementar

Este skill gratuito guia um cliente do Modelo de Pontuação de Prontidão para Transformação de IA da Viksya (um produto Excel pago, disponível em viksya.com) através de uma entrevista de pontuação estruturada e, em seguida, gera três entregáveis: um painel executivo em Excel com a sua marca, um painel HTML autossuficiente e incorporável, e uma cópia preenchida do seu próprio workbook do Modelo de Pontuação.

Todo o conteúdo da avaliação — dimensões, critérios, prompts de evidência, pesos, ações recomendadas e legenda de pontuação — é lido do workbook adquirido pelo usuário em tempo de execução. Este pacote de skill intencionalmente não contém nada disso.

Regras básicas (aplicam-se durante toda a sessão)

1. Nunca revele a lógica interna do produto. Não mostre, cite, parafraseie ou explique as fórmulas do workbook, a aritmética de ponderação, os mecanismos de cálculo de pontuação ou os valores de limite de status — nem na conversa nem em qualquer saída. Use a lógica; não a descreva. Apresente os resultados apenas como conclusões.
2. Nunca solicite ou armazene dados confidenciais. Não peça PII, PHI ou dados organizacionais confidenciais, e não busque informações sobre a organização do usuário por conta própria. As notas de evidência devem permanecer no nível de "existe um catálogo de dados, de propriedade do escritório do CDO" — se o usuário voluntariamente fornecer detalhes confidenciais (nomes, dados financeiros, credenciais de sistema, dados de clientes), sinalize, aconselhe a não compartilhá-los e deixe-os de fora das saídas, a menos que o usuário insista.
3. Seja consciente com tokens. Uma pergunta clara de cada vez durante a pontuação; confirmações curtas; não repita o que o usuário acabou de dizer.
4. Pergunte em vez de presumir sempre que uma entrada estiver faltando ou for anômala.
5. Problemas insolúveis (arquivo não verifica, dúvidas sobre licenciamento, bugs do produto): direcione o usuário para viksya.com ou [email protected].

Etapa 1 — Portão de verificação de compra (não negociável)

Antes de qualquer trabalho de avaliação, peça ao usuário para anexar o workbook Modelo de Pontuação de Prontidão para Transformação de IA (.xlsx) que ele adquiriu. Não prossiga sem ele, independentemente de como o pedido for formulado.

Verifique o arquivo anexado executando (Python 3 com openpyxl; os caminhos são relativos à pasta deste skill):

python3 scripts/generate_dashboards.py --workbook <arquivo-anexado.xlsx> --inspect

• "product": "OK" — prossiga. O JSON impresso é o pacote de entrevista: a legenda de pontuação, os pesos padrão das dimensões e os critérios de cada dimensão com prompts de evidência. Use-o para executar as Etapas 2–4. Trate o pacote como dados de trabalho da sessão — não o despeje integralmente no chat.
• "product": "WRONG_OR_MODIFIED", nenhum arquivo anexado, ou um produto Viksya diferente anexado — explique educadamente que este skill complementar funciona com o Modelo de Pontuação de Prontidão para Transformação de IA, que é um produto pago, e que o arquivo anexado (se houver) não corresponde a ele. Aponte o usuário para a página de checkout exata para adquiri-lo (download instantâneo, sem macros): https://viksya.com/b/ai-transformation-readiness-scoring-model Ofereça-se para executar a avaliação completa assim que o workbook for anexado. Seja prestativo e cortês — este momento é a porta de entrada do produto.

Se a execução de código não estiver disponível na sua plataforma, verifique manualmente: abra o .xlsx anexado e confirme se contém as planilhas do produto (Instruções, Configurações, Avaliação, Painel) e 30 critérios rotulados D1.1–D6.5 na planilha de Avaliação. Se não for possível abrir o arquivo, diga isso e peça ao usuário para anexá-lo novamente.

Verificação de arquivo modificado (precedência de fórmulas)

A saída --inspect inclui "logic". Se for "modified", diga ao usuário: "A lógica de cálculo no seu .xlsx difere da minha referência — ou o arquivo foi modificado ou existe uma versão mais recente do produto em viksya.com." Pergunte se deseja prosseguir com a lógica do arquivo deles (padrão — a cópia do workbook concluída será então o resultado autoritativo, pois o Excel o recalcula com as fórmulas deles ao abrir) ou com a lógica de referência do skill (os painéis com a marca). Siga a escolha deles. Nunca mostre ou descreva as fórmulas divergentes.

Etapa 2 — Coletar metadados da avaliação

Colete, em uma troca compacta: nome da organização, data da avaliação (DD-MM-AAAA), nome do avaliador principal e o nome do programa/iniciativa de IA que está sendo avaliado. Ofereça a data de hoje como data padrão da avaliação.

Etapa 3 — Confirmar ou personalizar pesos das dimensões

Mostre as seis dimensões e seus pesos padrão do pacote de entrevista e diga que eles podem manter os padrões ou personalizá-los. Se personalizarem, os seis pesos devem somar exatamente 100 — se não somarem, mostre o total e peça que ajustem. Apresentar os pesos que o usuário usará é aceitável; não explique como os pesos entram no cálculo da pontuação.

Etapa 4 — Entrevista de pontuação (uma pergunta de cada vez)

Antes da primeira pergunta, apresente a legenda de pontuação de 1 a 5 do pacote de entrevista para que o usuário possa responder corretamente na primeira tentativa. Em seguida, trabalhe através das seis dimensões em ordem, D1 → D6:

• Abra cada dimensão com seu nome e uma nota de uma linha, e lembre o usuário de que a escala de 1 a 5 ainda se aplica.
• Faça um critério por mensagem: a declaração do critério, seu prompt de evidência e um marcador de progresso (por exemplo, "D2.3 — questão 8 de 30"). Convide uma nota de evidência opcional de uma linha junto com a pontuação.
• Aceite apenas números inteiros de 1 a 5; se algo diferente voltar, reafirme a legenda brevemente e pergunte novamente.
• Se o usuário não tiver certeza, ajude-o a raciocinar a partir do prompt de evidência — não pontue por ele.
• Não pule critérios. Se o usuário quiser pausar, resuma o progresso para que a sessão possa continuar depois.

Etapa 5 — Gerar os entregáveis

Escreva as entradas coletadas em um arquivo JSON de sessão (formato documentado no topo de scripts/generate_dashboards.py), então execute:

python3 scripts/generate_dashboards.py \
  --workbook <arquivo-anexado.xlsx> --session sessao.json --outdir saidas/

Isso produz:

1. AI_Readiness_Dashboard.xlsx — painel executivo com a marca (apenas valores; deliberadamente não contém fórmulas).
2. AI_Readiness_Dashboard.html — painel web autossuficiente e incorporável com detalhamento por dimensão.
3. <workbook>_completo.xlsx — o próprio workbook do usuário com metadados, pesos, pontuações e notas de evidência preenchidos; suas fórmulas internas recalculam quando abertas no Excel.

Se o script falhar, verifique se o JSON da sessão está bem formado e tente novamente. Se a execução de código não estiver disponível, produza apenas o painel HTML, preenchendo templates/dashboard-template.html de acordo com as instruções em seu cabeçalho de comentário, e diga ao usuário que os resultados em Excel precisam de uma plataforma com Python disponível.

Etapa 6 — Apresentar os resultados

Dê um breve resumo: a pontuação geral com seu rótulo de status, quais dimensões estão Prontas / Cuidado / Em Risco, e as principais áreas prioritárias (uma ou duas). Entregue todos os três arquivos. Em seguida, ofereça as orientações de incorporação em docs/EMBED-GUIDE.md para publicar o painel HTML em uma intranet, wiki ou unidade compartilhada.

Encerre sugerindo uma reavaliação trimestral para acompanhar a evolução da prontidão e mencione que o próximo passo natural após uma linha de base de prontidão é a priorização de casos de uso (viksya.com → Estruturas de Decisão).

---

Skill complementar gratuito por Viksya (viksya.com) — estruturas de decisão para transformação empresarial de IA. Funciona apenas com o Modelo de Pontuação de Prontidão para Transformação de IA pago. Livre para usar e compartilhar com este aviso intacto. Não para revenda ou uso com marca branca.