Habilidade de Loop de Verificação

Um sistema de verificação completo para sessões do Claude Code.

Quando Usar

Chame esta habilidade:

• Após completar uma funcionalidade ou uma mudança de código significativa
• Antes de criar um PR (Pull Request)
• Quando quiser garantir que os portões de qualidade sejam aprovados
• Após refatoração

Fases de Verificação

Fase 1: Verificação de Build

set -o pipefail  # report the build's exit status, not tail's
# Check if project builds
npm run build 2>&1 | tail -20
# OR
pnpm build 2>&1 | tail -20

Se o build falhar, PARE e corrija antes de continuar.

Fase 2: Verificação de Tipo

set -o pipefail
# TypeScript projects
npx --no-install tsc --noEmit 2>&1 | sed -n '1,30p'

# Python projects
pyright . 2>&1 | sed -n '1,30p'

Reporte todos os erros de tipo. Corrija os críticos antes de continuar.

Fase 3: Verificação de Lint

Use sed para limitar a saída exibida enquanto consome todo o stream. Isso impede que um linter bem-sucedido falhe em SIGPIPE quando pipefail estiver ativado.

set -o pipefail
# JavaScript/TypeScript
npm run lint 2>&1 | sed -n '1,30p'

# Python
ruff check . 2>&1 | sed -n '1,30p'

Fase 4: Suíte de Testes

set -o pipefail
# Run tests with coverage
npm run test -- --coverage 2>&1 | tail -50

# Check coverage threshold
# Target: 80% minimum

Reporte:

• Total de testes: X
• Passaram: X
• Falharam: X
• Cobertura: X%

Fase 5: Análise de Segurança

# Check for secrets
grep -rn "sk-" --include="*.ts" --include="*.js" . 2>/dev/null | head -10
grep -rn "api_key" --include="*.ts" --include="*.js" . 2>/dev/null | head -10

# Check for console.log
grep -rn "console.log" --include="*.ts" --include="*.tsx" src/ 2>/dev/null | head -10

Fase 6: Revisão de Diff

# Show what changed
git diff --stat
git diff HEAD~1 --name-only

Revise cada arquivo alterado para:

• Mudanças não intencionais
• Tratamento de erro ausente
• Casos de borda potenciais

Formato de Saída

Após executar todas as fases, produza um relatório de verificação:

VERIFICATION REPORT
==================

Build:     [PASS/FAIL]
Types:     [PASS/FAIL] (X errors)
Lint:      [PASS/FAIL] (X warnings)
Tests:     [PASS/FAIL] (X/Y passed, Z% coverage)
Security:  [PASS/FAIL] (X issues)
Diff:      [X files changed]

Overall:   [READY/NOT READY] for PR

Issues to Fix:
1. ...
2. ...

Modo Contínuo

Para sessões longas, execute a verificação a cada 15 minutos ou após mudanças importantes:

Set a mental checkpoint:
- After completing each function
- After finishing a component
- Before moving to next task

Run: /verify

Integração com Hooks

Esta habilidade complementa os hooks PostToolUse, mas fornece uma verificação mais profunda. Os hooks capturam problemas imediatamente; esta habilidade fornece uma revisão completa.