Communitygithub.com

Prevenção de Vazamento de Git

Coleção de habilidades para agentes de IA voltadas ao desenvolvimento de sistemas web e aplicações — TypeScript, React, shadcn/ui, convenções de commit.

O que é Prevenção de Vazamento de Git?

Esta habilidade automatiza a prevenção de vazamento de dados confidenciais em repositórios Git. Ela escaneia arquivos rastreados em busca de segredos, chaves privadas, artefatos de build e outros itens sensíveis, e corrige automaticamente o arquivo `.gitignore` para evitar que esses arquivos sejam enviados ao GitHub. A habilidade também remove do rastreamento do Git os arquivos já comprometidos, mantendo uma cópia local, e gera um relatório claro com as ações tomadas e as medidas necessárias, como a rotação de chaves expostas. Suporta ambientes Windows (PowerShell e Command Prompt) e é compatível com agentes como Claude Code, Cursor e Codex, sendo ideal para equipes que usam TypeScript, React e shadcn/ui.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add bilals2008/bilal-skills

Perguntar na sua IA favorita

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

Documentação

O que Prevenção de Vazamento de Git faz?

Propósito

Evitar que arquivos sensíveis, segredos e artefatos de build sejam enviados ao GitHub. Escaneie, detecte e corrija automaticamente o .gitignore.

Instruções

Passo 1 — Escaneie por arquivos sensíveis

Execute este comando para encontrar arquivos que NÃO deveriam estar no GitHub:

git ls-files | findstr /i ".env .env.local .env.production .env.staging node_modules dist build releases *.key *.pem *.p12 secrets"

No PowerShell:

git ls-files | Select-String -Pattern "\.env|node_modules|dist|build|releases|\.key$|\.pem$|\.p12$|secrets|\.log$|\.cache$"

Verifique também arquivos sensíveis não rastreados:

git status --porcelain

Passo 2 — Verifique padrões comuns de sensibilidade

Procure por estes padrões nos arquivos rastreados:

PadrãoRiscoAção
.env / .env.*Chaves de API, senhas de BDRemover do git + adicionar ao .gitignore
node_modules/Dependências (enormes, não necessárias)Remover + .gitignore
dist/ / build/Saída compiladaRemover + .gitignore
releases/Lançamentos bináriosRemover + .gitignore
*.key / *.pemChaves privadasRemover + .gitignore
*.p12 / *.pfxCertificadosRemover + .gitignore
.DS_StoreMetadados macOS.gitignore
Thumbs.dbMetadados Windows.gitignore
*.logArquivos de log.gitignore
.cache/Pastas de cache.gitignore
coverage/Cobertura de testes.gitignore
.turbo/ / .next/Caches de build.gitignore
*.sqlDumps de banco (às vezes com segredos)Verificar conteúdo

Passo 3 — Verifique segredos no código

Pesquise por segredos codificados em arquivos rastreados:

rg -i "(api[_-]?key|secret|password|token|private[_-]?key)\s*[:=]\s*['\"x22]" --type-add 'code:*.{ts,tsx,js,jsx,json,yaml,yml,env,config}' -t code

Procure por padrões como:

  • API_KEY=sk-...
  • SECRET=...
  • PASSWORD=...
  • PRIVATE_KEY-----BEGIN
  • token: "eyJ..."

Passo 4 — Corrija automaticamente o .gitignore

Se arquivos sensíveis forem encontrados, atualize automaticamente o .gitignore:

# Verifique o .gitignore atual
cat .gitignore

Adicione as entradas ausentes. .gitignore padrão para projetos web:

# Arquivos de ambiente
.env
.env.local
.env.production
.env.staging
.env.development

# Dependências
node_modules/

# Saída de build
dist/
build/
release/
releases/

# Segredos
*.key
*.pem
*.p12
*.pfx

# IDE
.vscode/settings.json
.idea/

# SO
.DS_Store
Thumbs.db

# Logs
*.log
npm-debug.log*

# Cache
.cache/
.turbo/
.next/
.nuxt/

# Cobertura
coverage/

# Diversos
*.swp
*.swo

Passo 5 — Remova arquivos sensíveis do rastreamento git (se já estiverem rastreados)

Se arquivos sensíveis já estiverem rastreados:

# Remove do rastreamento, mas mantém localmente
git rm --cached .env
git rm --cached -r node_modules/
git rm --cached -r dist/
git rm --cached -r build/

# Depois adicione ao .gitignore

AVISO: Se segredos foram enviados ao GitHub, eles estão comprometidos. O usuário deve:

  1. Rotacionar todas as chaves/segredos expostos imediatamente
  2. Nunca usar os mesmos segredos novamente

Passo 6 — Mostre o relatório ao usuário

Apresente os resultados de forma clara:

🔍 Relatório de Escaneamento de Segurança

Arquivos em risco:
  ❌ .env — rastreado (contém segredos)
  ❌ node_modules/ — rastreado (deveria ser ignorado)
  ⚠️ dist/ — rastreado (saída de build)

Ações tomadas:
  ✅ Adicionado .env ao .gitignore
  ✅ Adicionado node_modules/ ao .gitignore
  ✅ Adicionado dist/ ao .gitignore
  ✅ Removido .env do rastreamento git (mantido localmente)

⚠️ Se .env continha segredos reais, ROTACIONE-os agora.
   O histórico do GitHub ainda contém a versão antiga.

Passo 7 — Faça o commit da correção

git add .gitignore
git commit -m "chore(security): update gitignore to prevent secret leaks"

O que NÃO fazer

  • ❌ Nunca mostre valores reais de segredos no relatório (mascare-os: sk-****...****)
  • ❌ Nunca faça commit de .env ou segredos, mesmo por motivos "temporários"
  • ❌ Nunca ignore o aviso se segredos já foram enviados
  • ❌ Nunca pule a verificação de git ls-files — arquivos não rastreados são ok, rastreados são o risco

Saída Esperada

Um relatório de segurança limpo mostrando:

  1. O que foi encontrado em risco
  2. O que foi corrigido automaticamente
  3. O que o usuário precisa fazer manualmente (rotacionar chaves)

Habilidades Relacionadas