Communitygithub.com

AI Slop Cleaner

Limpe o código gerado por IA com um fluxo de trabalho focado em exclusão, seguro contra regressão e modo opcional apenas para revisão.

O que é AI Slop Cleaner?

O AI Slop Cleaner é uma skill especializada para agentes de IA (como Claude Code, Cursor ou Codex) que remove código 'slop' — código gerado por IA que funciona, mas é inchado, repetitivo, fracamente testado ou excessivamente abstrato. Ela segue um fluxo de trabalho disciplinado que prioriza exclusão sobre adição, protege o comportamento existente com testes de regressão e executa passes focados em odores específicos (código morto, duplicação, abstração desnecessária, violações de limites e testes ausentes). A skill oferece um modo `--review` que separa as funções de escritor e revisor para garantir que alterações de alto impacto sejam validadas antes da aprovação. Pode ser limitada a uma lista explícita de arquivos e se integra perfeitamente com o Ralph (oh-my-claudecode) como um passe de limpeza pós-revisão. O resultado é sempre um relatório conciso e rico em evidências, listando arquivos alterados, simplificações, bloqueio de comportamento e riscos remanescentes.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Yeachan-Heo/oh-my-claudecode/tree/main/skills/ai-slop-cleaner

Perguntar na sua IA favorita

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

Documentação

O que AI Slop Cleaner faz?

Use esta skill para limpar código 'slop' gerado por IA sem desviar o escopo ou alterar o comportamento pretendido. No OMC, este é o fluxo de trabalho de limpeza delimitado para código que funciona, mas parece inchado, repetitivo, fracamente testado ou excessivamente abstrato.

Quando Usar

Use esta skill quando:

  • o usuário disser explicitamente deslop, anti-slop ou AI slop
  • a solicitação for limpar ou refatorar código que parece ruidoso, repetitivo ou excessivamente abstrato
  • a implementação subsequente deixou lógica duplicada, código morto, camadas de wrapper, vazamentos de limites ou cobertura de regressão fraca
  • o usuário quiser um passe anti-slop apenas de revisor via --review
  • o objetivo for simplificação e limpeza, não entrega de novos recursos

Quando Não Usar

Não use esta skill quando:

  • a tarefa for principalmente uma construção de novo recurso ou mudança de produto
  • o usuário quiser um redesenho amplo em vez de um passe de limpeza incremental
  • a solicitação for uma refatoração genérica sem intenção de simplificação ou anti-slop
  • o comportamento estiver muito incerto para proteger com testes ou um plano de verificação concreto

Postura de Execução OMC

  • Preserve o comportamento, a menos que o usuário peça explicitamente alterações de comportamento.
  • Bloqueie o comportamento primeiro com testes de regressão focados sempre que prático.
  • Escreva um plano de limpeza antes de editar o código.
  • Prefira exclusão a adição.
  • Reutilize utilitários e padrões existentes antes de introduzir novos.
  • Evite novas dependências, a menos que o usuário as solicite explicitamente.
  • Mantenha os diffs pequenos, reversíveis e focados em odores.
  • Seja conciso e rico em evidências: inspecione, edite, verifique e relate.
  • Trate novas instruções do usuário como atualizações de escopo local sem abandonar restrições anteriores não conflitantes.

Uso de Lista de Arquivos com Escopo

Esta skill pode ser limitada a uma lista explícita de arquivos ou escopo de arquivos alterados quando o solicitante já conhece a superfície de limpeza segura.

  • Boa adequação: oh-my-claudecode:ai-slop-cleaner skills/ralph/SKILL.md skills/ai-slop-cleaner/SKILL.md
  • Boa adequação: uma sessão do Ralph entregando apenas os arquivos alterados nessa sessão
  • Preserve o mesmo fluxo de trabalho seguro contra regressão mesmo quando o escopo for uma lista curta de arquivos
  • Não expanda silenciosamente um escopo de arquivos alterados em um trabalho de limpeza mais amplo, a menos que o usuário peça explicitamente

Integração com Ralph

O Ralph pode invocar esta skill como um passe de limpeza pós-revisão delimitado.

  • Nesse fluxo de trabalho, o limpador executa no modo padrão (não --review)
  • O escopo de limpeza são apenas os arquivos alterados da sessão do Ralph
  • Após o passe de limpeza, o Ralph executa novamente a verificação de regressão antes da conclusão
  • --review permanece o modo de acompanhamento apenas para revisores, não o caminho de integração padrão do Ralph

Modo de Revisão (--review)

--review é um passe apenas para revisores após o trabalho de limpeza ter sido rascunhado. Ele existe para preservar a separação explícita entre escritor e revisor para trabalho anti-slop.

  • Passe do escritor: faça as alterações de limpeza com o comportamento bloqueado por testes.
  • Passe do revisor: inspecione o plano de limpeza, os arquivos alterados e as evidências de verificação.
  • O mesmo passe não deve tanto escrever quanto auto-aprovar uma limpeza de alto impacto sem uma etapa de revisão separada.

No modo de revisão:

  1. Não comece editando arquivos.
  2. Revise o plano de limpeza, os arquivos alterados e a cobertura de regressão.
  3. Verifique especificamente:
    • código morto restante ou exports não utilizados
    • lógica duplicada que deveria ter sido consolidada
    • wrappers ou abstrações desnecessárias que ainda borram limites
    • testes ausentes ou verificação fraca para comportamento preservado
    • limpeza que parece ter alterado o comportamento sem intenção
  4. Produza um veredito do revisor com acompanhamentos necessários.
  5. Passe as alterações necessárias de volta para um passe de escritor separado, em vez de corrigir e aprovar em uma única etapa.

Fluxo de Trabalho

  1. Proteja o comportamento atual primeiro

    • Identifique o que deve permanecer igual.
    • Adicione ou execute os testes de regressão mais restritos necessários antes de editar.
    • Se os testes não puderem vir primeiro, registre o plano de verificação explicitamente antes de tocar no código.
  2. Escreva um plano de limpeza antes do código

    • Delimite o passe aos arquivos ou área de recurso solicitados.
    • Liste os odores concretos a serem removidos.
    • Ordene o trabalho da exclusão mais segura para a consolidação mais arriscada.
  3. Classifique o slop antes de editar

    • Duplicação — lógica repetida, branches copiados e colados, helpers redundantes
    • Código morto — código não utilizado, branches inatingíveis, flags obsoletas, sobras de debug
    • Abstração desnecessária — wrappers de passagem, indireção especulativa, camadas de helper de uso único
    • Violações de limites — acoplamento oculto, responsabilidades mal colocadas, imports de camada errada ou efeitos colaterais
    • Testes ausentes — comportamento não bloqueado, cobertura de regressão fraca, lacunas de casos extremos
    • Padrões de UI/design — padrões visuais genéricos que fazem uma interface construída por IA parecer não revisada

Checklist do Revisor de UI/Design

Use estes como prompts de revisão, não proibições absolutas. Mantenha escolhas intencionais de marca, acessibilidade, densidade de produto ou sistema de design quando tiverem uma justificativa clara.

  • Legibilidade em coreano: sinalize texto do corpo definido em torno de 11-12px; o texto do corpo em coreano geralmente precisa de pelo menos 14px, a menos que uma exceção validada de dados densos se aplique.
  • Moderação de sombra: questione sombras de caixa em todas as superfícies, logotipo, fundo, cartão ou ícone; mantenha sombras apenas onde elas esclarecem elevação ou interação.
  • Hierarquia de conteúdo: remova o preenchimento repetitivo de subtítulo/título/descrição/ extra quando o título já carrega a mensagem; evite emblemas genéricos de emoji, a menos que façam parte da voz do produto.
  • Justificativa da paleta: questione paletas azul/roxo padrão de IA, especialmente #3B82F6 do Tailwind, quando não existir justificativa de marca ou sistema.
  • Ritmo de layout: evite grades uniformes excessivamente perfeitas de 3 ou 4 colunas quando o contexto do produto se beneficia de ritmo, ênfase, assimetria, tratamento de carrossel/bento ou pesos de cartão variados.
  • Moderação de gradiente: suavize gradientes extremos, a menos que a marca possua deliberadamente essa linguagem visual.
  1. Execute um passe focado em um odor de cada vez

    • Passe 1: Exclusão de código morto
    • Passe 2: Remoção de duplicatas
    • Passe 3: Limpeza de nomenclatura e tratamento de erros
    • Passe 4: Reforço de teste
    • Execute verificação direcionada novamente após cada passe.
    • Não agrupe refatorações não relacionadas no mesmo conjunto de edições.
  2. Execute as portas de qualidade

    • Mantenha os testes de regressão verdes.
    • Execute os testes de lint, typecheck e unit/integração relevantes para a área tocada.
    • Execute verificações estáticas ou de segurança existentes quando disponíveis.
    • Se uma porta falhar, corrija o problema ou desfaça a limpeza arriscada em vez de forçá-la.
  3. Encerre com um relatório rico em evidências Sempre relate:

    • Arquivos alterados
    • Simplificações
    • Bloqueio de comportamento / execução de verificação
    • Riscos restantes

Uso

  • /oh-my-claudecode:ai-slop-cleaner <alvo>
  • /oh-my-claudecode:ai-slop-cleaner <alvo> --review
  • /oh-my-claudecode:ai-slop-cleaner <arquivo-a> <arquivo-b> <arquivo-c>
  • Do Ralph: execute o limpador apenas nos arquivos alterados da sessão do Ralph e, em seguida, retorne ao Ralph para verificação de regressão pós-limpeza

Boas Adequações

Boa: deslop este módulo: muitos wrappers, helpers duplicados e código morto

Boa: limpe o slop de IA em src/auth e restrinja limites sem alterar o comportamento

Ruim: refatore auth para suportar SSO

Ruim: limpe a formatação

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

agent-doc-discipline

Writing-time discipline for documents agents consume (the five surfaces, specs, tickets, .omc/skills/) — every rule checkable and carrying a why, steps before reference, one meaning in one home, no restating what the environment already says. Mandatory at drydock seed generation and the launch C5 sediment pass; opt-in for any other agent-facing doc edit. The companion of minimal-code-discipline: that one disciplines code, this one disciplines papers.

ask

Process-first advisor routing for Claude, Codex, Gemini, Antigravity, Grok, or Cursor via `omc ask`, with artifact capture and no raw CLI assembly

ask-navigator

Shipyard

autopilot

Full autonomous execution from idea to working code

autoresearch

Stateful single-mission improvement loop with strict evaluator contract, markdown decision logs, and max-runtime stop behavior

cancel

Cancel any active OMC mode (autopilot, ralph, ultragoal, swarm, ultrapilot, pipeline, team) and clean up retired legacy state

configure-notifications

Configure notification integrations (Telegram, Discord, Slack) via natural language

debug

Diagnose the current OMC session or repo state using logs, traces, state, and focused reproduction

deepinit

Deep codebase initialization with hierarchical AGENTS.md documentation

deep-interview

Socratic deep interview with mathematical ambiguity gating before explicit execution approval

drydock

Lay the keel of the shipyard harness in any repo — the 4-pillar shared environment (Context, Rules, Tools, Standards) across 5 surfaces (CLAUDE.md, skills, design-system, mcp/cli, shared context) so that every human and agent inherits the same design language and anyone can ship. Run once per repo; re-run with --check to audit drift.

execute

Carry an approved task through to working, verified code

external-context

Invoke parallel document-specialist agents for external web searches and documentation lookup

graph

Deterministic orchestration graph runtime - declarative DAG pipelines with journal-based crash recovery

harbor

Harbor intake for external work — the captain only handles unresolved decisions. Sweeps incoming issues and PRs, verifies every claim before disposition, reuses every decision already made, and hands the maintainer a docket whose pending items each carry one question with options, recommendation, impact and evidence. Agent-autonomous for facts and for actions covered by standing authorization; signed for every new judgment. Never merges.

hud

Configure HUD display options (layout, presets, display elements)

launch

Shipyard

loft

Loft the shape before cutting steel — answer a design question that prose cannot settle by building a throwaway artifact: a pure logic module in a clickable shell, or structurally different UI variants behind one route. The captain reacts to the artifact; the answer folds into the decision; the artifact never docks. Use when a design question stalls in words, when a navigator map carries a loft ticket, or when a spec discussion reaches

minimal-code-discipline

YAGNI-ladder coding discipline for writing changes — existence-first, reuse before writing, dependency ladder, shortest correct diff, with non-negotiables that must never be minimized away

omc-doctor

Diagnose and fix oh-my-claudecode installation issues

Habilidades Relacionadas