Skill
Security Audit (Cloudflare)
Crédito: cloudflare no GitHub (cloudflare/security-audit-skill) · 0 cópias
Indicada na UseIA por Cristiano Rochenbach Abreu em 5 de out. de 2026
24,8 mil estrelas no GitHubVer no GitHub
Tradução feita por IA. Em caso de dúvida, vale o texto original (aba “Original”).
---
name: security-audit
description: Orientação de segurança e revisão de vulnerabilidades para bases de código, APIs, serviços, ferramentas de CLI, bibliotecas e daemons. Use para perguntas de segurança, revisões focadas, pesquisa de vulnerabilidades, auditorias de segurança ou pentests. Execute o fluxo completo apenas para pedidos explícitos de auditoria de código ou pentest, revisões completas/abrangentes/de ponta a ponta ou artefatos de relatório solicitados.
---
# Security Audit
Encontre vulnerabilidades que violam uma fronteira de confiança real e depois entregue aos responsáveis a evidência no código-fonte, uma reprodução segura, a prioridade e a menor correção eficaz. É um fluxo defensivo, que começa pelo código-fonte. Um candidato sem um principal, recurso ou resultado de segurança afetado e concreto não é um achado confirmado.
## Modos de operação
Esta skill é, por padrão, apenas orientação. Carregá-la não autoriza o fluxo completo de auditoria nem a criação de arquivos.
- **Modo orientação**: Para perguntas de segurança, revisões focadas, metodologia, triagem ou investigação de achados específicos, use apenas as partes relevantes desta skill. Não execute automaticamente as seis fases, não crie um diretório de saída nem escreva artefatos de auditoria. Você pode acionar agentes focados quando for útil; eles devolvem os resultados à tarefa atual.
- **Modo auditoria completa**: Use o fluxo completo quando o usuário pedir explicitamente para auditar ou fazer pentest em uma base de código, pedir uma revisão de segurança completa, abrangente ou de ponta a ponta, ou solicitar artefatos de relatório. Execute as seis fases e escreva os arquivos definidos abaixo.
Se o pedido puder significar qualquer um dos dois modos, faça uma pergunta focada antes de criar arquivos ou iniciar o fluxo completo.
## Terminologia de plataforma
Esta skill é neutra quanto ao agente:
- **Parent** é o agente que coordena a execução e é dono do estado compartilhado.
- **Task tool** é o mecanismo de delegação ou de subagentes da plataforma.
- **Agente `research`** é um agente delegado para exploração focada do código-fonte e verificação de fatos.
- **Agente `general`** é um agente delegado para investigação ampla e execução local limitada.
- **`subagent_type:`** em um título indica qual desses dois papéis de agente delegado executa aquele trabalho.
Use capacidades equivalentes da plataforma, preservando as fronteiras de papel, de isolamento de escrita, de prompt e de independência.
## Segurança universal de execução
Estas regras valem nos dois modos de operação. A inspeção do código-fonte é somente leitura. Execute builds, testes, processos, navegadores, emuladores, fuzzers e processamento de fixtures controlados pelo alvo apenas dentro de um sandbox imposto pelo sistema operacional que ofereça todos estes controles:
- sem rede externa; use apenas um namespace de loopback isolado quando a verificação precisar de tráfego local cliente/servidor;
- um ambiente vazio, preenchido a partir de uma lista de permissão explícita com valores seguros, com `HOME`, diretórios temporários e caches locais ao scratch;
- um alvo e uma toolchain somente leitura, com o processo controlado pelo alvo podendo escrever apenas dentro do diretório `scratch/` que lhe foi atribuído; e
- limites explícitos e baixos de CPU, memória, processos, tamanho de arquivo, disco e tempo de relógio.
O agente, fora do processo controlado pelo alvo, pode fazer uma cópia descartável do código-fonte em um diretório `scratch/` atribuído quando um build precisar escrever ao lado do código. No modo orientação, não retenha arquivos controlados pelo alvo. No modo auditoria completa, apenas código confiável do lado do parent pode promover o resultado mínimo e não secreto para o `artifacts/` retido, usando o procedimento descrito em Isolamento de escrita. Nunca exponha ao código do alvo um diretório de saída retido (exceto o `scratch/` atribuído ao próprio agente), o diretório de outro agente, o diretório home do host, credenciais, sockets ou serviços compartilhados. Não instale dependências nem deixe os builds buscá-las. Use apenas as ferramentas e dependências já disponíveis localmente. Se nem todos os controles puderem ser aplicados, não execute o código do alvo: relate a capacidade de sandbox ausente como um bloqueio de needs-validation e apresente um plano seguro de validação.
Use principais, fixtures e segredos fictícios. Não sonde endpoints implantados, serviços externos, infraestrutura compartilhada, identidades de produção, dados de outros usuários nem planos de controle ao vivo. Não teste disponibilidade contra um processo ao vivo ou compartilhado, não publique artefatos, não altere releases, não gaste cota paga de API e não vá além do efeito local mínimo necessário para estabelecer um defeito. Se o fato decisivo estiver fora do código-fonte ou da fixture em sandbox, relate-o como necessitando validação.
## Preparação da auditoria completa
No modo auditoria completa, resolva estes valores antes do reconhecimento:
- **Diretório da skill**: o diretório absoluto que contém este `SKILL.md`.
- **Alvo**: a raiz absoluta do repositório sob revisão.
- **Nome do repositório**: um identificador estável do repositório, a partir do diretório ou do remoto Git local.
- **Diretório de saída**: um novo diretório gravável fora do alvo, por padrão `~/security-audit-skill/<repo-name>/run-<N>`, em que `<N>` é o próximo inteiro não usado. Use um diretório dentro do alvo apenas quando o usuário o selecionar explicitamente e o parent verificar que o controle de versão ignora o diretório inteiro. Caso contrário, pare e peça um caminho externo.
- **Referência do código-fonte**: o commit revisado e se a árvore de trabalho está suja. Não trate arquivos gerados ou modificados que não foram revisados como outra revisão.
### Isolamento de escrita
O parent cria e é o único que escreve os arquivos compartilhados da execução:
- `run-metadata.json`
- `architecture.md`
- `coverage-ledger.json`
- `findings.json`
- `REPORT.md`
- `FINDINGS-DETAIL.md`
- `NEEDS-VALIDATION.md`
Cada hunter ou verifier recebe uma raiz exclusiva em `<output-dir>/agents/<agent-id>/`, com diretórios `scratch/` e `artifacts/` separados. Os IDs canônicos de agentes seguem `^[a-z0-9][a-z0-9_-]{0,63}$` e não podem ser iguais a um nome de dispositivo do Windows, como `con`, `prn`, `aux`, `nul`, `com1` a `com9` ou `lpt1` a `lpt9`. IDs em minúsculas evitam colisões por diferença de caixa. O agente e todo processo controlado pelo alvo só podem escrever em `scratch/`; o `artifacts/` retido pertence ao parent, nunca é exposto ao sandbox e só pode ser escrito por código confiável de promoção do lado do parent. Os agentes não podem alterar arquivos compartilhados, o código-fonte do alvo, artefatos retidos nem o diretório de outro agente. Não use `/tmp` nem o diretório home do host como alternativa gravável.
Antes da execução, o parent abre e mantém descritores de diretório confiáveis e não herdáveis para as raízes `scratch/` e `artifacts/` do agente e registra uma lista de permissão dos arquivos de artefato esperados, relativos ao scratch, com limites explícitos de bytes por arquivo e cumulativos. Nunca passe esses descritores ao agente nem ao sandbox. Depois que o sandbox e todos os seus processos terminarem, o código confiável do lado do parent promove cada arquivo da lista de permissão separadamente:
1. Valide o caminho relativo declarado: rejeite componentes absolutos, vazios, `.`, `..` ou com link simbólico.
2. Percorra cada componente pai a partir do descritor retido da raiz do scratch com operações relativas ao diretório, sem seguir links; nunca reabra por caminho.
3. Abra a folha sem seguir links e sem bloquear.
4. Verifique com `fstat` que é um arquivo regular, com contagem de links exatamente igual a um e dentro dos limites de bytes por arquivo e cumulativo registrados.
5. Aplique esses limites de novo durante a leitura a partir desse descritor.
6. Copie exatamente o tamanho verificado, repita o `fstat` e rejeite qualquer mudança de identidade, tipo, contagem de links ou tamanho.
7. Para o destino, percorra cada componente pai a partir do descritor retido da raiz de artifacts com operações relativas ao diretório, sem seguir links; exija que cada componente existente seja um diretório real e crie qualquer diretório ausente de forma exclusiva antes de reabri-lo e verificá-lo sem seguir links.
8. Crie a folha de forma exclusiva, sem seguir links, verifique que o destino aberto é um arquivo regular com contagem de links exatamente igual a um e copie a partir do descritor de origem verificado, sem reabrir nenhum dos dois caminhos.
9. Use APIs equivalentes e seguras contra condições de corrida em sistemas não POSIX.
10. Nunca copie recursivamente nem use glob no scratch, nunca extraia um arquivo compactado para artifacts e nunca abra ou promova um link simbólico, FIFO, socket, dispositivo, diretório, arquivo com hard link, arquivo que muda ou arquivo que exceda o limite.
11. Se qualquer verificação estiver indisponível, não puder ser aplicada ou falhar, descarte a entrada do scratch; se ela for evidência decisiva, mantenha `needs_validation` com o bloqueio exato da promoção.
[HUNTING.md](HUNTING.md) e [VALIDATION-AND-REPORTING.md](VALIDATION-AND-REPORTING.md) trazem este procedimento como um único bloco idêntico, entre cercas de código, para os prompts de hunter e verifier; ele enuncia as mesmas regras na mesma ordem desta lista.
Em uma verificação reproduzida, registre o comando, a entrada exata de teste, os limites do sandbox e apenas os nomes das variáveis de ambiente da lista de permissão, mais os valores seguros e não secretos necessários para reproduzi-la. Nunca capture nem copie o ambiente, as variáveis herdadas, os valores de credenciais, o estado de autenticação nem caminhos do host sem relação com o caso. Inicie a partir de um ambiente vazio, em vez de tentar redigir um ambiente depois da execução.
Antes da delegação, o parent escreve o `run-metadata.json` com pelo menos `run_id`, `repo`, `target`, `source_ref`, `profile`, `scope_paths`, `budget` (nulo se não definido), `execution_policy: "sandboxed-source-and-local-only"`, os arquivos complementares selecionados, os caminhos de execuções anteriores, os donos dos arquivos compartilhados e `run_status: "in_progress"`. Atualize os metadados apenas quando esses fatos mudarem; o estado dos candidatos pertence ao ledger de cobertura e ao `findings.json`.
## Planejamento da auditoria completa
Os requisitos de cobertura, execuções anteriores, perfil e orçamento desta seção valem apenas no modo auditoria completa.
### Cobertura e execuções anteriores
Nenhuma passada é completa. Monte um plano de cobertura determinístico antes de caçar vulnerabilidades e atualize-o após cada resultado de agente. O [RECONNAISSANCE.md](RECONNAISSANCE.md) define as unidades de cobertura estáveis e o [HUNTING.md](HUNTING.md) define as ondas de coverage-critic. Apenas o parent atualiza o ledger.
Se existirem execuções anteriores, leia todo `coverage-ledger.json` e `findings.json` compatível antes de planejar a execução atual:
1. Compare o código-fonte atual relevante com cada registro e unidade anteriores. A referência de código-fonte anterior, por si só, não é evidência de que um caminho não mudou.
2. Leve um registro `confirmed` anterior para o conjunto de candidatos atual apenas quando o seu relevan
[…] Conteúdo completo no GitHub.Funciona com:Claude

