agentleFS
felvieirafelvieira/claude-skills-fv/skills/34-static-analysis/SKILL.md

static-analysis

Skill28 starsChanged 3 months agoApache-2.0View on GitHub

Analisa vulnerabilidades, bugs e sinais de manutencao com evidencias. Trigger em: "semgrep", "codeql", "static analysis", "scan de seguranca", "SAST", "varredura", "pre-deploy security", "OWASP scan", "CVE check", "auditoria automatizada", "CRAP score", "complexidade ciclomática", "duplicação estrutural".

  • Installs packages

13 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use build-keil, can-debug and 10 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • ZhongYechengSkill

    build-keil

    当需要通过 Keil MDK 命令行编译嵌入式工程,调用自带脚本解析工程文件、执行构建并定位固件产物时使用。

    Also in 3 projects that use this

  • ZhongYechengSkill

    can-debug

    当需要调试 CAN 总线通信时使用,支持通过 USB-CAN 适配器监听、发送 CAN 帧和扫描节点。

    Also in 3 projects that use this

  • iPlug2Skill

    build-cmake

    Build an iPlug2 plugin project using CMake with Ninja, Xcode, or Visual Studio generators

    Also in 3 projects that use this

  • +9 more from ZhongYecheng

The file

We split this skill into the rules it gives an agent

1 rule. 0 are common, 1 is distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 8 edited versions we read keep these.

  • 1

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Detectar linguagens: do repositorio

    line 61

“Common” is measured: kept by at least 6 in 10 of the 8 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Static Analysis — Scan Automatizado de Vulnerabilidades

Eleva a Security Review (skill 06) de "review manual" para "scan + triagem". Semgrep para velocidade e cobertura ampla, CodeQL para taint tracking interprocedural quando o caso exige.

Governanca Global

Esta skill segue GLOBAL.md, policies/execution.md, policies/tool-safety.md, policies/quality-gates.md, policies/writing-clarity.md.

Consultar docs/skill-guides/static-analysis.md para rulesets avancados, custom rules e integracao em CI.

Evidência de manutenção sob demanda

Complexidade por função, cobertura e duplicação estrutural ajudam a priorizar investigação; não substituem SAST nem comprovam qualidade arquitetural. Reutilize medições disponíveis da mesma revisão e do mesmo escopo. Sem dados confiáveis, registre ausência, falha, incompatibilidade ou resultado antigo; não preencha com zero ou aprovação.

node scripts/code-quality-report.mjs --input <json> [--json] consolida dados normalizados e calcula CRAP quando complexidade e cobertura da função estão disponíveis. O script não executa scanners nem valida os artefatos citados. O formato e os limites estão em docs/skill-guides/architecture-and-evidence.md; examples/code-quality-input.json é uma demonstração sintética.

Classifique similaridades como candidatas antes de propor extração. Confirme que significado, invariantes e motivos para mudar coincidem; justifique duplicações mantidas. Encaminhe decisões de estrutura à skill 38 e qualidade dos testes à skill 05. Limites bloqueantes vêm do projeto; não adote um CRAP ou percentual de similaridade universal.

Quando Usar

  • pre-release (toda release passa por scan)
  • PR que toca auth, validacao de input, parsing, serializacao, deps externas
  • bug encontrado: rodar variant analysis para achar similares
  • suspeita de classe de bug recorrente (ex: SQL injection, SSRF, prototype pollution)
  • antes de promover modulo para producao
  • auditoria periodica (mensal ou trimestral)
  • investigação de complexidade por função ou candidatos a duplicação, quando solicitada

Quando Nao Usar

  • não ampliar bugfix localizado para scan completo sem risco ou pedido que justifique
  • não transformar refactor sem risco de segurança em SAST obrigatório; métricas podem ser analisadas quando pertinentes
  • não impor a bateria completa a uma prototipagem descartável

Entradas Esperadas

  • caminho do repositorio ou subdiretorio
  • linguagens predominantes
  • (opcional) ruleset especifico ou bug similar a procurar

Saidas Esperadas

  • relatorio em SARIF (.sarif) ou markdown estruturado
  • findings classificados por severidade (Critical / High / Medium / Low / Info)
  • triagem (true positive / false positive / needs investigation)
  • handoff para skill 06 (Security Review) com top findings
  • handoff para debugger se finding tiver root cause nao trivial

Responsabilidades / Protocolo

  1. Detectar linguagens do repositorio
  2. Selecionar rulesets apropriados (default: --config=auto + ruleset OWASP)
  3. Executar scan (Semgrep primeiro; CodeQL se padrao envolve fluxo)
  4. Gerar SARIF + relatorio markdown
  5. Triagem — classificar TP/FP/needs-investigation
  6. Suprimir FPs com comentario justificando
  7. Handoff para skill 06 com sumario
  8. Variant analysis se padrao recorrer (custom rule)
  9. CI integration quando aplicavel

Detalhes operacionais nas sub-secoes a seguir.

Ferramentas

Semgrep (default — comecar por aqui)

Instalar:

pip install semgrep
# ou via Docker
docker run --rm -v "$PWD:/src" returntocorp/semgrep semgrep --config=auto

Rodar:

# Auto: detecta linguagens, aplica rulesets oficiais
semgrep --config=auto --sarif --output=semgrep.sarif

# Ruleset especifico
semgrep --config=p/owasp-top-ten --sarif --output=owasp.sarif
semgrep --config=p/security-audit
semgrep --config=p/typescript

# Custom rule
semgrep --config=./my-rule.yml src/

Rulesets recomendados por linguagem:

  • TS/JS: p/typescript, p/javascript, p/react, p/nextjs, p/owasp-top-ten
  • Python: p/python, p/django, p/flask, p/owasp-top-ten
  • Go: p/golang, p/gosec
  • Java: p/java, p/spring
  • Geral: p/security-audit, p/secrets, p/ci

CodeQL (quando precisar de taint tracking interprocedural)

Instalar:

# Download CodeQL CLI
# https://github.com/github/codeql-cli-binaries/releases

Rodar:

# Build database
codeql database create db --language=javascript --source-root=.

# Run query suite
codeql database analyze db --format=sarif-latest --output=results.sarif \
  codeql/javascript-queries

# Custom query
codeql query run --database=db my-query.ql

Quando usar CodeQL em vez de Semgrep:

  • bug envolvendo data flow entre funcoes/arquivos
  • bug que so aparece em condicoes de chamada especificas
  • variant analysis sofisticada apos achar bug inicial

Subagents auxiliares (despachaveis via Task tool)

Para escala (multi-linguagem, >20 findings, variant analysis), despachar via Task:

  • semgrep-scanner — executa scans em paralelo por categoria de linguagem, agrega SARIF. Use quando repo tem 2+ linguagens primarias.
  • semgrep-triager — classifica findings em TP/FP/needs-investigation lendo contexto fonte. Use quando ha >20 findings.
  • codeql-runner — orquestra build de database CodeQL + queries com taint tracking interprocedural. Use quando bug envolve data flow entre arquivos/funcoes.
  • sarif-parsing — parse, dedup, agregacao de SARIF de multiplas fontes. Use quando consolidar Semgrep + CodeQL ou multiplos scans.
  • variant-analysis — caca variantes do mesmo padrao apos achar bug inicial, gera custom rule reusavel. Use apos confirmar bug que pertence a classe (SQLi, XSS, missing auth, etc).

Cada subagent tem definicao em .claude/agents/<name>.md com protocolo, inputs, outputs e guardrails proprios. Para uso simples (1 linguagem, scan rapido, poucos findings), rodar inline conforme blocos abaixo.

Pipeline Recomendado

1. Semgrep --config=auto    (5-30s, cobertura ampla)
   → triage via `semgrep-triager` subagent (ou inline se <20 findings)
   → fix critical/high
2. Se finding for bug de fluxo: CodeQL com query especifica
   → variant analysis para achar similares
3. SARIF → markdown report → handoff para skill 06
4. Skill 06 valida findings + adiciona contexto OWASP
5. Reviewer (skill 11) bloqueia merge se Critical/High aberto

Triagem de Findings

Para cada finding, classificar:

  • True Positive (TP) — bug real, fix obrigatorio (Critical/High)
  • False Positive (FP) — regra disparou em codigo seguro, suprimir com justificativa
  • Needs Investigation — comportamento ambiguo, escalar para skill 06

Suprimir FP corretamente:

// nosemgrep: rule-id  // motivo: contexto valida input acima na linha 42
const sql = `SELECT * FROM users WHERE id = ${id}`;

Nao suprimir sem comentario explicando porque.

Checkpoint por TP corrigido: aplicar o fix → rodar o scanner de novo só naquele arquivo → confirmar que o finding original sumiu E que nenhum finding novo apareceu no mesmo arquivo (fix de SQLi que remove sanitização de outro campo, por exemplo). Se sumir mas surgir outro, corrigir o novo antes de marcar o TP como resolvido — não é aceitável trocar um finding critical por outro.

Severidade

NivelCritérioAcao
CriticalRCE, SQLi, XSS confirmado, secret hardcodedbloqueia merge, fix imediato
HighAuth bypass possivel, SSRF, deps com CVE highbloqueia merge, fix antes da release
MediumValidacao fraca, missing rate limit, dep com CVE mediumfix no proximo sprint
LowCode smell, deprecated API, missing header opcionalbacklog
InfoSugestao de hardeningopcional

Anti-Rationalization Table (Triagem de Findings)

Triagem de findings tem viesses recorrentes. Pensamentos que significam STOP:

PensamentoRealidade
"Isso parece falso positivo"Validacao em outro arquivo nao garante. Verificar fluxo real.
"Eu sei que esse codigo e seguro"Sem evidencia (validacao explicita ou teste), e suposicao.
"Esse modulo e legado, nao toca"Legado e onde CVE mora. Tratar igual.
"Suprimir e mais rapido"FP nao validado vira buraco de seguranca em 6 meses.
"A regra e generica, nao se aplica"Genericas pegam padroes reais. Investigar antes de descartar.
"Tem outros bugs maiores agora"Critical/High nao espera. Triagem e pre-deploy gate.
"Funcionava antes do scan"Bug existia antes — scan so revelou.
"Vamos abrir issue e seguir"Critical aberto = no merge. Issue nao substitui fix.

Toda supressao precisa de comentario explicando por que o codigo e seguro naquele contexto.

Quando Criar Custom Rules

  • bug recorrente que rulesets oficiais nao pegam
  • padrao especifico do projeto (ex: nunca chamar internalApi.X sem auditLog)
  • regra de negocio que vira invariante de seguranca

Exemplo Semgrep:

rules:
  - id: missing-audit-log
    pattern: |
      internalApi.$X(...)
    pattern-not: |
      auditLog($Y)
      ...
      internalApi.$X(...)
    message: chamada a internalApi sem auditLog precedente
    severity: ERROR
    languages: [typescript]

Custom rules vivem em tools/semgrep/ ou .semgrep/ no repo.

Output Format

Markdown estruturado para handoff:

# Static Analysis Report — <YYYY-MM-DD>

**Tool:** semgrep --config=auto + p/owasp-top-ten
**Scope:** src/
**Duration:** 23s
**Files scanned:** 247

## Summary
- Critical: 1
- High: 3
- Medium: 8
- Low: 14
- Info: 22

## Critical Findings

### F-001: SQL Injection em src/db/users.ts:42
**Rule:** javascript.lang.security.sql-injection
**Confidence:** high (TP confirmed)
**Evidence:**
```ts
const query = `SELECT * FROM users WHERE id = ${userId}`;

Fix: usar prepared statement

const query = `SELECT * FROM users WHERE id = $1`;
db.query(query, [userId]);

Owner: skill 03 (Backend)

High Findings

...

Suppressed (FP)

  • src/legacy/oldHash.ts:88 — weak-crypto: hash usado para deduplicacao, nao seguranca

## Integracao com CI

Adicionar a `.github/workflows/`:

```yaml
- name: Semgrep scan
  run: semgrep --config=auto --error --severity=ERROR

--error faz CI quebrar em finding Critical/High.

Codigo Limpo

Output deve seguir policies/writing-clarity.md. Sem narrativa, sem hedging, sem prosa decorativa. Tabela de findings + acao concreta por linha.

Evidencia de Conclusao

  • relatorio SARIF gerado (timestamped)
  • findings triados (TP/FP/needs-investigation)
  • top Critical/High com fix sugerido
  • FPs suprimidos com comentario justificando
  • handoff para skill 06 com sumario

Handoff

Apos conclusao, entregar:

  1. caminho do .sarif + .md
  2. contagem por severidade
  3. lista de Critical/High que bloqueiam merge
  4. sugestao: skill 06 valida, debugger investiga root cause complexo, variant analysis se padrao recorrente

Integracao com Pipeline

  • Security Review (skill 06): consome output, valida contexto OWASP, bloqueia release
  • Debugger (subagent): investiga root cause de finding com fluxo complexo
  • Reviewer (skill 11): quality gate — Critical/High aberto = no merge
  • Release Manager (skill 24): scan obrigatorio antes de cada release
  • Migration & Refactor (skill 23): scan antes/depois de refactor grande para detectar regressao

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.