rxlqn/know-your-unknowns

Uma habilidade para Codex e Claude que revela incógnitas com artefatos de agente.

O que é know-your-unknowns?

Esta habilidade, 'know-your-unknowns', foi projetada para agentes de IA como Codex e Claude, permitindo que eles identifiquem e explorem lacunas de conhecimento — as 'incógnitas' — durante tarefas de engenharia de software. Ela atua como um mecanismo de reflexão, incentivando o agente a reconhecer o que não sabe, documentar essas incertezas e transformá-las em artefatos acionáveis, como listas de questões abertas, dependências não resolvidas ou suposições a validar. Ao tornar explícitos os pontos cegos, esta ferramenta melhora a qualidade geral do raciocínio, ajuda a prevenir conclusões prematuras e gera um artefato de agente (geralmente um arquivo Markdown ou JSON) que pode ser compartilhado ou revisado. É particularmente útil em cenários complexos de solução de problemas, onde a compreensão completa do domínio é crítica, e se integra perfeitamente com os fluxos de trabalho existentes do agente, sem exigir configuração externa.

Funciona com✓Claude Code✓Codex CLI~Cursor
npx skills add rxlqn/know-your-unknowns

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

O que know-your-unknowns faz?

Uma habilidade para Codex e Claude que revela incógnitas com artefatos de agente.

Esta habilidade permite que agentes de IA identifiquem e documentem lacunas de conhecimento durante tarefas de engenharia de software, promovendo uma compreensão mais profunda e evitando suposições não verificadas.

Plataformas Suportadas

  • Claude (Agentes)
  • Codex (Agentes)

Como Usar

  1. Inicie uma sessão do agente com esta habilidade carregada.
  2. Durante a execução de uma tarefa, o agente pode invocar o mecanismo de 'incógnitas conhecidas' para listar o que ainda não é totalmente compreendido.
  3. O agente gerará um artefato (ex.: descobertas-incognitas.md) contendo as questões, dependências e suposições identificadas.
  4. Revise e refine o artefato conforme necessário para orientar os próximos passos.

Exemplo de Artefato Gerado

# Incógnitas Conhecidas para [Tarefa/Cenário]

## Questões Abertas
- O que causa a degradação de desempenho no módulo X?
- Quais são as dependências exatas da biblioteca Y?

## Suposições Não Validadas
- O sistema pode escalar horizontalmente sem modificações no código.
- A API externa permanecerá compatível com a versão atual.

## Dependências Não Resolvidas
- Migração do banco de dados baseada em esquema ainda não finalizado.
- Integração com serviço de terceiros requer chaves de API adicionais.

Benefícios

  • Maior Consciência: O agente reconhece explicitamente suas próprias limitações de conhecimento.
  • Melhor Tomada de Decisão: Com incertezas documentadas, ações podem ser priorizadas com base no impacto potencial.
  • Colaboração: Artefatos compartilháveis permitem que outros desenvolvedores ou agentes contribuam com informações.

Nota Técnica

A habilidade funciona como uma diretiva integrada ao prompt do agente, sem necessidade de configuração adicional. O comportamento pode ser personalizado ajustando-se o formato do artefato (Markdown, JSON, etc.) dentro da definição da habilidade.


Para sugestões ou contribuições, consulte o repositório rxlqn/know-your-unknowns.

Habilidades Relacionadas