audit-context-building
Ajuda seu agente a analisar código linha por linha para entender sua estrutura. É útil antes de procurar por falhas ou problemas de segurança.
O que ela faz
Esta ferramenta ajuda a IA a entender o código de um programa linha por linha, como se estivesse desmontando um relógio peça por peça. Ela foca em entender profundamente como tudo funciona antes de procurar por problemas.
Quando usar
- ✓Quando você precisa entender um código complexo antes de procurar erros.
- ✓Para ter certeza de que a IA compreendeu todos os detalhes de um programa.
- ✓Ao preparar uma análise de segurança ou revisão de arquitetura.
Exemplo do que pedir para a IA
“Analise este código linha por linha, focando em entender cada passo e as suposições feitas.”
Quer saber mais? Abra as seções abaixo.
Como usar
O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.
Link da skill
Mensagem pronta para colar
Como funciona
A IA examina cada linha e bloco de código, aplicando métodos como 'Por quê?' repetidamente para desvendar a lógica. Ela constrói um mapa mental detalhado do programa, conectando as partes ao todo.
Instalação
Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.
No terminal (Claude Code, Codex, Cursor), na pasta do projeto:
npx skills add sickn33/agentic-awesome-skills --skill audit-context-buildingOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/plugins/agentic-awesome-skills-claude/skills/audit-context-building/SKILL.md -o SKILL.mdConteúdo técnico (SKILL.md)
Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.
Habilidade Deep Context Builder (Modo Puro de Contexto Ultra-Granular)
1. Propósito
Esta habilidade governa como Claude pensa durante a fase de construção de contexto de uma auditoria.
Quando ativa, Claude irá:
- Realizar análise de código linha por linha / bloco por bloco por padrão.
- Aplicar Princípios Fundamentais, 5 Porquês e 5 Comos em microescala.
- Ligar continuamente insights → funções → módulos → sistema inteiro.
- Manter um modelo mental estável e explícito que evolui com novas evidências.
- Identificar invariantes, suposições, fluxos e perigos de raciocínio.
Esta habilidade define um formato de análise estruturado (veja Exemplo: Micro-Análise de Função abaixo) e é executada antes da fase de caça a vulnerabilidades.
Quando Usar
Use quando:
- Compreensão profunda é necessária antes da descoberta de bugs ou vulnerabilidades.
- Você deseja um entendimento de baixo para cima em vez de suposições de alto nível.
- Reduzir alucinações, contradições e perda de contexto é crítico.
- Preparando-se para auditoria de segurança, revisão de arquitetura ou modelagem de ameaças.
Não use para:
- Descoberta de vulnerabilidades
- Recomendações de correção
- Raciocínio de exploração
- Classificação de severidade/impacto
2. Como Esta Habilidade Se Comporta
Quando ativa, Claude irá:
- Padrão para análise ultra-granular de cada bloco e linha.
- Aplicar Princípios Fundamentais, 5 Porquês e 5 Comos em nível micro.
- Construir e refinar um modelo mental global persistente.
- Atualizar suposições anteriores quando contraditas ("Anteriormente eu pensava X; agora Y.").
- Periodicamente ancorar resumos para manter um contexto estável.
- Evitar especulação; expressar incerteza explicitamente quando necessário.
Objetivo: compreensão profunda e precisa, não conclusões.
Racionalizações (Não Pule)
| Racionalização | Por que está Errada | Ação Necessária |
|---|---|---|
| "Entendi a ideia geral" | O entendimento geral perde casos extremos | Análise linha por linha é necessária |
| "Esta função é simples" | Funções simples compõem bugs complexos | Aplique 5 Porquês de qualquer forma |
| "Vou lembrar deste invariante" | Você não vai. O contexto degrada. | Escreva explicitamente |
| "Chamada externa provavelmente está ok" | Externo = adversarial até prova em contrário | Mergulhe no código ou modele como hostil |
| "Posso pular este helper" | Helpers contêm suposições que se propagam | Rastreie a cadeia de chamadas completa |
| "Isso está demorando muito" | Contexto apressado = vulnerabilidades alucinadas depois | Devagar é rápido |
3. Fase 1 — Orientação Inicial (Análise de Baixo para Cima)
Antes da análise profunda, Claude realiza um mapeamento mínimo:
- Identificar módulos/arquivos/contratos principais.
- Anotar pontos de entrada públicos/externos óbvios.
- Identificar prováveis atores (usuários, proprietários, relayers, oráculos, outros contratos).
- Identificar variáveis de armazenamento importantes, dicionários, structs de estado ou células.
- Construir uma estrutura preliminar sem supor comportamento.
Isso estabelece âncoras para análise detalhada.
4. Fase 2 — Análise de Função Ultra-Granular (Modo Padrão)
Cada função não trivial recebe análise micro completa.
5.1 Checklist de Microestrutura por Função
Para cada função:
Propósito
- Por que a função existe e seu papel no sistema.
Entradas e Suposições
- Parâmetros e entradas implícitas (estado, remetente, ambiente).
- Pré-condições e restrições.
Saídas e Efeitos
- Valores de retorno.
- Escritas de estado/armazenamento.
- Eventos/mensagens.
- Interações externas.
Análise Bloco por Bloco / Linha por Linha Para cada bloco lógico:
- O que ele faz.
- Por que aparece aqui (lógica de ordenação).
- Em quais suposições ele se baseia.
- Quais invariantes ele estabelece ou mantém.
- Qual lógica posterior depende dele.
Aplicar por bloco:
- Princípios Fundamentais
- 5 Porquês
- 5 Comos
5.2 Análise de Fluxo Inter-Funções e Externo
(Integração Completa da Regra de Mergulhar em Código Externo)
Ao encontrar chamadas, continue a mesma análise micro-inicial através das fronteiras.
Chamadas Internas
- Mergulhe na função chamada imediatamente.
- Realize análise bloco por bloco do código relevante.
- Rastreie o fluxo de dados, suposições e invariantes: chamador → chamado → retorno → chamador.
- Observe se a lógica da função chamada se comporta de forma diferente neste contexto de chamada específico.
Chamadas Externas — Dois Casos
Caso A — Chamada Externa para um Contrato Cujo Código Existe na Base de Código Trate como uma chamada interna:
- Mergulhe no contrato/função de destino.
- Continue a micro-análise bloco por bloco.
- Propague invariantes e suposições de forma contínua.
…
Perguntas frequentes
Isso vai encontrar bugs para mim?
Não diretamente. O objetivo principal é construir um entendimento profundo do código. A busca por bugs vem depois, com base nesse entendimento.
Por que analisar linha por linha se o código parece simples?
Mesmo funções simples podem causar problemas quando combinadas. A análise detalhada garante que nenhuma suposição ou detalhe importante seja ignorado.
O que são 'Primeiros Princípios' ou '5 Porquês' neste contexto?
São métodos para questionar a lógica. 'Primeiros Princípios' é pensar nas verdades fundamentais. '5 Porquês' é perguntar 'por quê?' repetidamente para chegar à causa raiz de algo.
Detalhes
Descrição original do autor
Enables ultra-granular, line-by-line code analysis to build deep architectural context before vulnerability or bug finding.
Popularidade
- Estrelas no GitHub
- 48 mil
- Posição no ranking
- #2223
- Licença
- MIT
- Atualizada em
- 15/10/2026
Comentários
- …
Mais skills deste repositório
00-andruia-consultant
Ajuda seu agente a iniciar ou melhorar projetos de IA. Ele analisa código, sugere ferramentas e cria planos de ação em espanhol.
sickn33/agentic-awesome-skills
007
Faz seu agente realizar auditorias de segurança e modelagem de ameaças. É útil para proteger projetos contra ataques e vulnerabilidades.
sickn33/agentic-awesome-skills
10-andruia-skill-smith
Ajuda seu agente a criar ou melhorar ferramentas de IA. Ele define como as ferramentas funcionam, escreve a documentação e valida a estrutura.
sickn33/agentic-awesome-skills
20-andruia-niche-intelligence
Faz seu agente criar um resumo sobre um setor específico. É útil para entender o contexto, regras, padrões de uso e riscos de um projeto, usando fontes confiáveis.
sickn33/agentic-awesome-skills
Skills parecidas
benchmark-optimization-loop
Faz seu agente melhorar a velocidade de algo de forma medida. Ele testa várias versões e escolhe a mais rápida que ainda funciona corretamente.
affaan-m/ECC
change-impact
Ajuda seu agente a analisar o impacto de mudanças no código antes de fazê-las. Ele compara o planejado com o real depois, cobrindo caminhos, dados, testes e documentação. É útil para mudanças arriscadas ou que afetam várias partes do sistema.
affaan-m/ECC
click-path-audit
Faz seu agente rastrear todos os botões e interações do usuário para achar bugs. Ele encontra problemas onde funções parecem funcionar sozinhas, mas falham juntas. Útil quando bugs persistem mesmo após depuração.
affaan-m/ECC