Nettoyeur de Slop IA

Que fait Nettoyeur de Slop IA ?

Utilisez cette compétence pour nettoyer le code généré par l'IA sans dériver dans le périmètre ni modifier le comportement prévu. Dans l'OMC, il s'agit du workflow de nettoyage borné pour le code qui fonctionne mais semble boursouflé, répétitif, faiblement testé ou trop abstrait.

Quand l'utiliser

Utilisez cette compétence lorsque :

• l'utilisateur dit explicitement deslop, anti-slop ou slop IA
• la demande est de nettoyer ou refactoriser du code qui semble bruyant, répétitif ou trop abstrait
• une implémentation de suivi a laissé de la logique dupliquée, du code mort, des couches d'encapsulation superflues, des fuites de limites ou une faible couverture de régression
• l'utilisateur souhaite un passage anti-slop en mode révision uniquement via --review
• l'objectif est la simplification et le nettoyage, pas la livraison de nouvelles fonctionnalités

Quand ne pas l'utiliser

N'utilisez pas cette compétence lorsque :

• la tâche est principalement une construction de nouvelle fonctionnalité ou un changement de produit
• l'utilisateur souhaite une refonte large plutôt qu'un passage de nettoyage incrémental
• la demande est une refactorisation générique sans intention de simplification ou anti-slop
• le comportement est trop flou pour être protégé par des tests ou un plan de vérification concret

Posture d'exécution OMC

• Préservez le comportement sauf si l'utilisateur demande explicitement des changements de comportement.
• Verrouillez le comportement avec des tests de régression ciblés en premier lieu, chaque fois que c'est pratique.
• Rédigez un plan de nettoyage avant de modifier le code.
• Préférez la suppression à l'ajout.
• Réutilisez les utilitaires et les motifs existants avant d'en introduire de nouveaux.
• Évitez les nouvelles dépendances sauf si l'utilisateur les demande explicitement.
• Gardez les diffs petits, réversibles et centrés sur les odeurs de code.
• Restez concis et riche en preuves : inspectez, modifiez, vérifiez et rapportez.
• Traitez les nouvelles instructions de l'utilisateur comme des mises à jour de périmètre local sans abandonner les contraintes antérieures non conflictuelles.

Utilisation d'une liste de fichiers délimitée

Cette compétence peut être limitée à une liste de fichiers explicite ou à un périmètre de fichiers modifiés lorsque l'appelant connaît déjà la surface de nettoyage sûre.

• Bon ajustement : oh-my-claudecode:ai-slop-cleaner skills/ralph/SKILL.md skills/ai-slop-cleaner/SKILL.md
• Bon ajustement : une session Ralph qui transmet uniquement les fichiers modifiés dans cette session
• Préservez le même workflow sûr contre la régression même lorsque le périmètre est une courte liste de fichiers
• N'étendez pas silencieusement un périmètre de fichiers modifiés en un travail de nettoyage plus large, sauf si l'utilisateur le demande explicitement

Intégration Ralph

Ralph peut invoquer cette compétence comme un passage de nettoyage post-révision borné.

• Dans ce workflow, le nettoyeur s'exécute en mode standard (pas --review)
• Le périmètre de nettoyage est uniquement les fichiers modifiés de la session Ralph
• Après le passage de nettoyage, Ralph réexécute la vérification de régression avant de terminer
• --review reste le mode de suivi réservé au réviseur, pas le chemin d'intégration Ralph par défaut

Mode Révision (--review)

--review est un passage réservé au réviseur après que le travail de nettoyage a été ébauché. Il existe pour préserver une séparation explicite rédacteur/réviseur pour le travail anti-slop.

• Passage rédacteur : effectuez les modifications de nettoyage avec le comportement verrouillé par des tests.
• Passage réviseur : inspectez le plan de nettoyage, les fichiers modifiés et les preuves de vérification.
• Le même passage ne doit pas à la fois écrire et auto-approuver un nettoyage à fort impact sans une étape de révision séparée.

En mode révision :

1. Ne commencez pas par modifier les fichiers.
2. Révisez le plan de nettoyage, les fichiers modifiés et la couverture de régression.
3. Vérifiez spécifiquement :
   • les restes de code mort ou d'exports inutilisés
   • la logique dupliquée qui aurait dû être consolidée
   • les encapsulations ou abstractions inutiles qui brouillent encore les limites
   • les tests manquants ou la vérification faible du comportement préservé
   • le nettoyage qui semble avoir modifié le comportement sans intention
4. Produisez un verdict de révision avec les actions de suivi requises.
5. Transmettez les modifications nécessaires à un passage rédacteur séparé au lieu de corriger et d'approuver en une seule étape.

Workflow

1. Protégez d'abord le comportement actuel

   • Identifiez ce qui doit rester identique.
   • Ajoutez ou exécutez les tests de régression les plus étroits nécessaires avant de modifier.
   • Si les tests ne peuvent pas venir en premier, enregistrez le plan de vérification explicitement avant de toucher au code.

2. Rédigez un plan de nettoyage avant le code

   • Délimitez le passage aux fichiers ou à la zone fonctionnelle demandée.
   • Listez les odeurs de code concrètes à supprimer.
   • Ordonnez le travail de la suppression la plus sûre à la consolidation la plus risquée.

3. Classez le slop avant de modifier

   • Duplication — logique répétée, branches copiées-collées, aides redondants
   • Code mort — code inutilisé, branches inaccessibles, indicateurs obsolètes, restes de débogage
   • Abstraction inutile — encapsulations passe-plat, indirection spéculative, couches d'aide à usage unique
   • Violations de limites — couplage caché, responsabilités mal placées, imports ou effets secondaires de mauvaise couche
   • Tests manquants — comportement non verrouillé, faible couverture de régression, lacunes dans les cas limites
   • Défauts d'interface/de design — motifs visuels génériques qui donnent l'impression qu'une interface construite par IA n'a pas été révisée

Liste de révision UI/Design

Utilisez-les comme des invites de révision, pas des interdictions absolues. Conservez les choix intentionnels de marque, d'accessibilité, de densité de produit ou de système de design lorsqu'ils ont une justification claire.

• Lisibilité du coréen : signalez le texte de corps défini autour de 11-12 px ; le corps de texte coréen a généralement besoin d'au moins 14 px, sauf si une exception validée pour les données denses s'applique.
• Retenue des ombres : questionnez les ombres de boîte sur chaque surface, logo, arrière-plan, carte ou icône ; ne conservez les ombres que là où elles clarifient l'élévation ou l'interaction.
• Hiérarchie du contenu : supprimez le bourrage répétitif d'eyebrow/titre/description/<p> supplémentaire lorsque le titre porte déjà le message ; évitez les badges émojis génériques à moins qu'ils ne fassent partie de la voix du produit.
• Justification de la palette : contestez les palettes bleu/violet par défaut de l'IA, en particulier #3B82F6 de style Tailwind, lorsqu'il n'existe aucune justification de marque ou de système.
• Rythme de mise en page : évitez les grilles uniformes trop parfaites à 3 ou 4 colonnes lorsque le contexte du produit bénéficie d'un rythme, d'une emphase, d'une asymétrie, d'un traitement carrousel/bento ou de poids de carte variés.
• Retenue des dégradés : atténuez les dégradés extrêmes à moins que la marque ne possède délibérément ce langage visuel.

4. Exécutez un passage centré sur une odeur de code à la fois

   • Passage 1 : Suppression du code mort
   • Passage 2 : Suppression des duplications
   • Passage 3 : Nettoyage des noms et de la gestion des erreurs
   • Passage 4 : Renforcement des tests
   • Réexécutez la vérification ciblée après chaque passage.
   • Ne regroupez pas des refactorisations non liées dans le même ensemble de modifications.

5. Exécutez les contrôles de qualité

   • Maintenez les tests de régression au vert.
   • Exécutez les tests de lint, de typage et unitaires/d'intégration pertinents pour la zone touchée.
   • Exécutez les vérifications statiques ou de sécurité existantes lorsqu'elles sont disponibles.
   • Si un contrôle échoue, corrigez le problème ou annulez le nettoyage risqué au lieu de le forcer.

6. Terminez par un rapport riche en preuves Rapportez toujours :

   • Fichiers modifiés
   • Simplifications
   • Verrouillage du comportement / exécution de vérification
   • Risques restants

Utilisation

• /oh-my-claudecode:ai-slop-cleaner <cible>
• /oh-my-claudecode:ai-slop-cleaner <cible> --review
• /oh-my-claudecode:ai-slop-cleaner <fichier-a> <fichier-b> <fichier-c>
• Depuis Ralph : exécutez le nettoyeur sur les fichiers modifiés de la session Ralph uniquement, puis revenez à Ralph pour la vérification de régression post-nettoyage

Bons ajustements

Bon : deslop ce module : trop d'encapsulations, d'aides dupliqués et de code mort

Bon : nettoie le slop IA dans src/auth et resserre les limites sans changer le comportement

Mauvais : refactorise auth pour prendre en charge le SSO

Mauvais : nettoie le formatage