Pular para o conteúdo
Skillpedia
Código em geral48 mil · #2223

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

https://github.com/sickn33/agentic-awesome-skills/blob/main/plugins/agentic-awesome-skills-claude/skills/audit-context-building/SKILL.md

Mensagem pronta para colar

Use esta skill para me ajudar: https://github.com/sickn33/agentic-awesome-skills/blob/main/plugins/agentic-awesome-skills-claude/skills/audit-context-building/SKILL.md Leia o arquivo SKILL.md desse link e siga as instruções dele na minha tarefa.
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-building

Ou 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.md
Conteú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:

  1. Identificar módulos/arquivos/contratos principais.
  2. Anotar pontos de entrada públicos/externos óbvios.
  3. Identificar prováveis atores (usuários, proprietários, relayers, oráculos, outros contratos).
  4. Identificar variáveis de armazenamento importantes, dicionários, structs de estado ou células.
  5. 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:

  1. Propósito

    • Por que a função existe e seu papel no sistema.
  2. Entradas e Suposições

    • Parâmetros e entradas implícitas (estado, remetente, ambiente).
    • Pré-condições e restrições.
  3. Saídas e Efeitos

    • Valores de retorno.
    • Escritas de estado/armazenamento.
    • Eventos/mensagens.
    • Interações externas.
  4. 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.

repo: sickn33/agentic-awesome-skills

Popularidade

Estrelas no GitHub
48 mil
Posição no ranking
#2223
Licença
MIT
Atualizada em
15/10/2026

Essa skill é útil?

0

Entre para votar.

Comentários

  • …

Mais skills deste repositório

Skills parecidas