analyse-problem

Visão geral do skill analyse-problem

Para que serve o analyse-problem

O skill analyse-problem transforma um problema bagunçado em um brief A3 estruturado: contexto, situação atual, estado desejado, análise de causa raiz, contramedidas, plano de implementação e acompanhamento. É a melhor opção para Strategic Planning, operações, produto e engenharia quando você precisa de uma definição do problema pronta para decisão, em vez de uma sessão de brainstorming.

Quem deve instalar

Instale o analyse-problem se você precisa explicar problemas com clareza com frequência, alinhar stakeholders ou sair de sintomas para causas. Ele funciona bem para quem quer um formato repetível para análise de incidentes, melhoria de processos, bloqueios de projeto ou sessões de planejamento.

O que o diferencia

O valor não está em “escrever mais com IA”; está na restrição. O analyse-problem força o modelo a documentar o problema em uma página, separar fatos de suposições e terminar com ações e verificação. Isso o torna mais útil do que um prompt genérico para analyse-problem em Strategic Planning, porque obriga um enquadramento mais apertado para a decisão.

Como usar o skill analyse-problem

Instale e acione

Use o fluxo de instalação do seu gerenciador de skills e, em seguida, invoque o skill analyse-problem com uma breve descrição do problema. O padrão de uso no repositório é /analyse-problem [problem_description], e o skill aceita uma descrição opcional do problema com saída em markdown por padrão. Se o seu ambiente mapear skills de outro jeito, transmita a mesma intenção: uma descrição concisa e concreta do problema.

Dê ao skill a entrada certa

Entradas fortes nomeiam o problema, o escopo e as evidências. Por exemplo: “A taxa de conclusão do onboarding de clientes caiu 18% neste mês nas contas enterprise; analise as causas e proponha contramedidas.” Entradas fracas como “melhorar o onboarding” deixam o modelo adivinhando objetivo, responsável e métrica de sucesso. Para usar analyse-problem bem, inclua:

• o sintoma
• o processo ou time afetado
• quaisquer dados, exemplos ou prazos
• o resultado desejado ou a restrição

Leia estas partes do repositório primeiro

Comece por SKILL.md e depois confira quaisquer instruções vinculadas em README.md, AGENTS.md, metadata.json e pastas como rules/, resources/, references/ ou scripts/, se existirem. Neste repositório, a fonte principal fica concentrada em plugins/kaizen/skills/analyse-problem, então há pouca estrutura adicional para rastrear.

Ajuste o prompt para obter um resultado melhor

Um bom prompt para o guia analyse-problem é específico o suficiente para preencher cada seção do A3. Por exemplo:
“Use analyse-problem para documentar por que os atrasos de release aumentaram no Q2. Inclua métricas de base, causas raiz prováveis, 3 contramedidas ranqueadas por impacto e esforço e um plano de acompanhamento de 30 dias.”
Isso gera um resultado muito mais útil do que pedir uma análise genérica, porque oferece fatos para organizar e uma decisão para sustentar.

FAQ do skill analyse-problem

O analyse-problem é só para Strategic Planning?

Não. Ele é útil sempre que um problema precisa ser enquadrado, investigado e desdobrado em ações: questões de produto, gargalos operacionais, falhas de processo do time ou revisões de planejamento estratégico. O formato A3 é amplo, mas o skill é mais valioso quando o resultado será compartilhado com outras pessoas.

Como isso é diferente de um prompt normal?

Um prompt comum pode pedir uma análise, mas o skill analyse-problem oferece uma estrutura reutilizável e disciplina de saída. Isso faz diferença quando você precisa de cobertura consistente de causa raiz, contramedidas e acompanhamento, em vez de uma explicação livre.

Um iniciante consegue usar bem?

Sim, desde que a entrada seja concreta. Iniciantes costumam travar quando o problema é vago, então informe o que você sabe: sintoma observado, escopo, timing e uma meta aproximada. O skill ajuda a organizar um raciocínio incompleto, mas não pode inventar fatos ausentes com segurança.

Quando eu não devo usar?

Não use analyse-problem quando você só precisa de um resumo rápido, uma atualização de status ou uma sessão de ideias criativas. Ele também é uma escolha ruim se o problema ainda não tiver um escopo estável; nesse caso, defina o problema primeiro antes de pedir uma análise estruturada.

Como melhorar o skill analyse-problem

Dê evidências, não só conclusões

O maior salto de qualidade vem de entradas concretas: métricas, exemplos, timestamps de incidentes, falas de usuários ou notas de processo. Se você já suspeita de uma causa raiz, rotule isso como hipótese, não como fato, para que a análise consiga testá-la em vez de apenas refletir a suspeita.

Peça uma saída útil para decisão

Para analyse-problem, peça o que vai ajudar um time a agir: causas ranqueadas, contramedidas ligadas às causas, responsáveis, dependências e um plano de verificação. Se você quer valor para Strategic Planning, solicite trade-offs de impacto e esforço em vez de uma narrativa longa.

Fique atento aos modos de falha mais comuns

A falha mais comum é explicar demais os sintomas e especificar de menos o estado desejado. Outra é misturar vários problemas em uma única página. Separe questões não relacionadas e mantenha uma análise focada em uma decisão, um responsável e um resultado mensurável.

Itere depois do primeiro rascunho

Use a primeira saída para checar lacunas: dados faltando, elos causais fracos ou ações que não combinam com a causa raiz. Depois, refine o prompt com novos fatos e restrições, como orçamento, prazo, capacidade do time ou um formato obrigatório para a revisão da liderança.