Pular para o conteúdo
Skillpedia
Testes48 mil · #2449

brooks-sweep

Ajuda seu agente a analisar e corrigir vários aspectos da qualidade do código automaticamente. Ele aplica correções seguras e pede confirmação para as mais arriscadas.

O que ela faz

Esta ferramenta analisa seu código em busca de problemas como envelhecimento, má arquitetura, dívida técnica e falhas nos testes. Ela tenta corrigir automaticamente os problemas mais simples e pede sua permissão para corrigir os mais complexos.

Quando usar

  • ✓Quando o código está ficando difícil de entender ou manter.
  • ✓Antes de adicionar novas funcionalidades importantes.
  • ✓Se você suspeita que há muitos erros escondidos no código.

Exemplo do que pedir para a IA

“Por favor, analise e corrija meu código em busca de problemas de qualidade.”

Quer saber mais? Abra as seções abaixo.

Como usar

O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.

Link da skill

https://github.com/sickn33/agentic-awesome-skills/blob/main/plugins/agentic-awesome-skills-claude/skills/brooks-sweep/SKILL.md

Mensagem pronta para colar

Use esta skill para me ajudar: https://github.com/sickn33/agentic-awesome-skills/blob/main/plugins/agentic-awesome-skills-claude/skills/brooks-sweep/SKILL.md Leia o arquivo SKILL.md desse link e siga as instruções dele na minha tarefa.
Como funciona

A ferramenta verifica seu código em quatro áreas: qualidade geral, testes, dívida técnica e auditoria. Ela aplica correções seguras automaticamente e pede sua aprovação para as mais arriscadas, sempre verificando se as correções funcionam.

Instalação

Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.

No terminal (Claude Code, Codex, Cursor), na pasta do projeto:

npx skills add sickn33/agentic-awesome-skills --skill brooks-sweep

Ou baixe só o arquivo:

curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/plugins/agentic-awesome-skills-claude/skills/brooks-sweep/SKILL.md -o SKILL.md
Conteúdo técnico (SKILL.md)

Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.

Brooks-Lint — Varredura Completa e Correção Automática

Quando Usar

Use esta habilidade quando precisar do modo de varredura completa: executa uma análise unificada em todas as dimensões de qualidade — decadência de código, arquitetura, débito técnico e qualidade de testes — e então aplica correções diretamente na base de código. Mudanças seguras são aplicadas automaticamente; mudanças arriscadas são confirmadas antes da execução. Baseado em doze clássicos...

Configuração

  1. Leia ../_shared/common.md para as regras da Lei de Ferro, Configuração de Projeto, Modelo de Relatório e Pontuação de Saúde
  2. Leia ../_shared/source-coverage.md para cobertura em nível de livro, exceções e trade-offs
  3. Leia ../_shared/decay-risks.md para definições de sintomas de risco de produção
  4. Leia ../_shared/test-decay-risks.md para definições de sintomas de risco de teste
  5. Leia sweep-guide.md neste diretório para o processo unificado de varredura e correção

Processo

Se o usuário não especificou um projeto ou diretório: aplique a Detecção de Escopo Automática de ../_shared/common.md para determinar o escopo da revisão antes de prosseguir.

  1. Mostre o aviso de consentimento pré-voo e aguarde a aprovação única do usuário (Passo 0 do guia)
  2. Enumere o escopo e inicialize o estado unresolvable / non_critical_rounds / fix_log (Passo 1 do guia)
  3. Execute as quatro dimensões em sequência — revisão, teste, débito, auditoria — cada uma escaneando, classificando, aplicando correções Seguras + Estendidas-Seguras e verificando através do comando de teste do projeto (Passos 2–5 do guia)
  4. Itere: re-escanear arquivos modificados + mesmo módulo + consumidores estáticos; convergir para uma rodada limpa, aposentar falhas de 3 tentativas no conjunto unresolvable, limitar rodadas não críticas a 3 (Passo 6 do guia)
  5. Agregue itens residuais e irresolúveis e gere o Relatório de Varredura Completa (Passos 7–8 do guia)

Linha de modo no relatório: Full Sweep

Limitações

  • Use esta habilidade apenas quando a tarefa corresponder claramente à sua fonte upstream e ao contexto do projeto local.
  • Verifique comandos, código gerado, dependências, credenciais e comportamento de serviços externos antes de aplicar mudanças.
  • Não trate exemplos como substitutos para testes específicos do ambiente, revisão de segurança ou aprovação do usuário para ações destrutivas ou custosas.
Perguntas frequentes

O que são 'mudanças seguras' e 'mudanças arriscadas'?

Mudanças seguras são aquelas que a ferramenta tem alta confiança de que não vão quebrar o código. Mudanças arriscadas são aquelas que podem ter um impacto maior e, por isso, pedem sua permissão antes de serem aplicadas.

O que acontece se a ferramenta não conseguir corrigir um problema?

Problemas que não puderam ser resolvidos automaticamente são registrados para que você possa analisá-los depois.

Preciso aprovar cada correção?

Não, apenas as correções consideradas arriscadas. As seguras são aplicadas automaticamente.

Detalhes

Descrição original do autor

Full-sweep mode: runs a unified analysis across all quality dimensions — code decay, architecture, tech debt, and test quality — then applies fixes directly to the codebase. Safe changes are auto-applied; risky changes are confirmed before execution.

repo: sickn33/agentic-awesome-skills

Popularidade

Estrelas no GitHub
48 mil
Posição no ranking
#2449
Licença
MIT
Atualizada em
15/10/2026

Essa skill é útil?

0

Entre para votar.

Comentários

  • …

Mais skills deste repositório

Skills parecidas