Skill de Lint e Validação
OBRIGATÓRIO: Execute ferramentas de validação apropriadas após CADA mudança de código. Não finalize uma tarefa até que o código esteja sem erros.
Procedimentos por Ecossistema
Node.js / TypeScript
- Lint/Fix:
npm run lintounpx eslint "path" --fix - Types:
npx tsc --noEmit - Segurança:
npm audit --audit-level=high
Python
- Linter (Ruff):
ruff check "path" --fix(Rápido & Moderno) - Segurança (Bandit):
bandit -r "path" -ll - Types (MyPy):
mypy "path"
O Ciclo de Qualidade
- Escrever/Editar Código
- Executar Auditoria:
npm run lint && npx tsc --noEmit - Analisar Relatório: Verifique a seção "RELATÓRIO FINAL DE AUDITORIA".
- Corrigir e Repetir: Submeter código com falhas no "RELATÓRIO FINAL" NÃO é permitido.
Tratamento de Erros
- Se
lintfalhar: Corrija os problemas de estilo ou sintaxe imediatamente. - Se
tscfalhar: Corrija incompatibilidades de tipo antes de prosseguir. - Se nenhuma ferramenta está configurada: Verifique a raiz do projeto por
.eslintrc,tsconfig.json,pyproject.tomle sugira criar uma.
Regra Rígida: Nenhum código deve ser enviado ou reportado como "concluído" sem passar nessas verificações.
Scripts
| Script | Propósito | Comando |
|---|---|---|
scripts/lint_runner.py |
Verificação de lint unificada | python scripts/lint_runner.py <project_path> |
scripts/type_coverage.py |
Análise de cobertura de tipos | python scripts/type_coverage.py <project_path> |