Menu
Nettoie les commentaires trop situationnels ou liés à la conversation dans les changements de la branche
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Récupère les N derniers fichiers d'un dossier (Downloads par défaut) et les affiche/lit. Cross-platform (macOS, Linux, WSL). Supporte aliases (downloads, desktop, pictures, screenshots, documents, videos, music) et offset négatif pour skip les plus récents.
Add, commit et push les changements. Ajouter "?" pour le mode garde-fou, "!" pour forcer sans confirmation même sur main.
Met à jour le README selon les derniers changements
Copie les fichiers .env depuis le worktree principal vers le worktree courant
Analyse et corrige les erreurs de CI (boucle watch jusqu'à green)
Lance le build et corrige les erreurs
| name | clean-comments |
| description | Nettoie les commentaires trop situationnels ou liés à la conversation dans les changements de la branche |
| user-invocable | true |
| allowed-tools | Read, Grep, Glob, Bash, Edit |
Détecte et nettoie les commentaires de code qui sont trop précis, trop situationnels, ou trop liés à une conversation spécifique dans les fichiers modifiés de la branche actuelle.
Quand on code avec un assistant IA, on génère parfois des commentaires qui :
Ces commentaires doivent être nettoyés pour garder un code professionnel.
git diff --name-only origin/main...HEAD
Pour chaque fichier, regarder les lignes ajoutées (+) qui contiennent des commentaires :
// pour JS/TS/Go/Rust/Swift/* */ pour JS/TS/CSS/Go/Rust/Swift# pour Python/Shell/YAML/Ruby{/* */} pour JSX/TSX<!-- --> pour HTML/Vue templates-- pour SQL/Lua/// pour Rust/C# doc commentsPatterns à détecter :
| Type | Exemple | Problème |
|---|---|---|
| Commentaire en français | // Vérifie si l'utilisateur est connecté | Doit être en anglais |
| Explication de workaround | // On fait ça car sinon le state ne se met pas à jour | Trop contextuel |
| Référence à un bug | // Fix pour éviter le crash quand X | Situationnel |
| Warning trop précis | // IMPORTANT: ne pas utiliser Y ici car... | Over-engineering |
| Explication évidente | // On vérifie si l'utilisateur existe | Redondant |
| Historique | // Avant on faisait X mais maintenant... | Pas pertinent |
| Conversation | // Comme demandé, on gère ce cas | Contextuel |
| TODO vagues | // TODO: améliorer plus tard | Inutile |
| Généré par IA | // As suggested by..., // Based on the discussion... | Contextuel |
| Justification IA | // Claude recommended..., // Per our conversation... | Contextuel |
| Removed/Changed | // removed X, // was previously Y | Historique |
Pour chaque commentaire détecté :
Supprimer si :
Traduire si :
Simplifier si :
Garder si :
Afficher les modifications proposées :
## Fichier: `path/to/file.ts`
### Ligne 42 - SUPPRIMER
```typescript
// On évite de faire X car ça causait un bug avec le state
const value = computeValue();
Raison : Code auto-explicatif, commentaire situationnel
Avant :
// IMPORTANT: On doit absolument vérifier ce cas car sinon quand l'utilisateur
// arrive depuis la page précédente avec un état invalide ça crash
if (!isValid) return null;
Après :
// Guard: invalid state
if (!isValid) return null;
### 6. Demander confirmation
Avant d'appliquer les modifications, lister tous les changements proposés et demander confirmation à l'utilisateur.
### 7. Appliquer les modifications
Une fois confirmé, utiliser l'outil Edit pour appliquer chaque modification.
## Règles de bon commentaire
Un bon commentaire :
- **Est toujours en anglais** (traduire si en français ou autre langue)
- Explique le **POURQUOI**, pas le **QUOI** (le code dit déjà quoi)
- Est intemporel (valide dans 6 mois sans contexte)
- Est concis (une ligne max si possible)
- Utilise un ton neutre et professionnel
## Output
1. Liste des commentaires problématiques avec proposition
2. Demande de confirmation
3. Application des modifications
4. Résumé final des changements effectués