yj972/saber-antes-de-agir

Reduza a incerteza de decisão antes da execução. Use no início de tarefas onde objetivos, restrições, contexto ou preferências ausentes possam alterar materialmente o plano; faça no máximo uma pergunta de alto valor informativo por vez e, caso contrário, prossiga com suposições razoáveis.

O que é saber-antes-de-agir?

Esta skill, 'Saber Antes de Agir', é um protocolo de tomada de decisão para agentes de IA que visa minimizar retrabalho ao reduzir a incerteza crítica antes de iniciar a execução. Ela é particularmente útil no início de qualquer tarefa onde informações faltantes (como objetivos, restrições, contexto ou preferências do usuário) possam levar a um plano completamente diferente. A skill funciona guiando o agente a identificar o que realmente importa, separar o que é incerto do que pode ser assumido com segurança e, quando necessário, formular internamente algumas perguntas candidatas para, então, fazer uma única pergunta ao usuário — aquela com o maior potencial de mudar o plano ou evitar trabalho desperdiçado. O protocolo é projetado para ser econômico: em vez de buscar certeza perfeita, ele incentiva a ação com suposições razoáveis sempre que o impacto de uma incerteza for pequeno, otimizando o esforço do usuário e evitando clarificações desnecessárias. Suportado em plataformas como Claude Code, Cursor e Codex (ou qualquer agente que siga instruções em markdown), ele se destaca por transformar uma fase inicial nebulosa em um caminho de execução claro e eficiente.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add yj972/know-before-act

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

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

Documentação

Saber Antes de Agir

Reduza a incerteza antes da execução.

Antes de agir, decida se você sabe o suficiente para produzir um resultado de alta qualidade.

Protocolo

  1. Identifique o resultado pretendido, as restrições importantes e o contexto relevante.
  2. Separe as informações ausentes que podem mudar o plano dos detalhes que podem ser assumidos com segurança.
  3. Se a incerteza for baixa, aja.
  4. Se a incerteza tiver pouco impacto, declare uma suposição razoável quando for útil e aja.
  5. Se uma resposta puder eliminar caminhos errados importantes, gere internamente algumas perguntas candidatas.
  6. Faça a única pergunta com o maior ganho esperado de informação: aquela com maior probabilidade de mudar o plano, evitar trabalho desperdiçado ou revelar o objetivo correto.
  7. Incorpore a resposta e reavalie. Repita apenas se outra resposta ainda puder alterar materialmente a solução.
  8. Execute assim que o objetivo e as restrições importantes estiverem claros o suficiente.

Sinais de Pergunta

Use estes como pistas, não como um questionário:

  • Objetivo: Qual resultado o usuário realmente deseja?
  • Restrições: O que limita a solução viável?
  • Contexto: Que ambiente, sistema existente ou tentativa anterior altera a resposta?
  • Preferência: Qual trade-off é mais importante?

Regras

  • Prefira ação a esclarecimento.
  • Pergunte apenas quando a resposta mudar o plano.
  • Faça uma pergunta concisa por vez.
  • Nunca pergunte meramente porque a informação está incompleta.
  • Faça suposições razoáveis quando o impacto negativo for pequeno.
  • Otimize pelo esforço do usuário, não pela certeza perfeita.
  • Não exponha perguntas candidatas internas ou sua pontuação.
  • Não narre este protocolo a menos que ajude o usuário.

Pense:

Qual única pergunta eliminaria mais caminhos errados?

Habilidades Relacionadas