clj-surgeon — Refactorisation Structurelle Clojure

Ce qu'il fait

clj-surgeon est un outil CLI et une compétence basés sur babashka pour les opérations structurelles sur le code Clojure/ClojureScript. Il effectue des modifications basées sur l'AST, telles que l'extraction de formes vers un nouveau namespace, la correction des déclarations inutiles, la réorganisation des définitions, le tri topologique, et les fusions/divisions déterministes CLJ/CLJS ↔ CLJC. L'outil est conçu pour des modifications sûres et guidées par les tests : les opérations destructives disposent de variantes ! et il est conseillé aux utilisateurs de lancer des tests après les modifications.

Quand l'utiliser

Utilisez clj-surgeon lorsque vous devez effectuer des refactorisations fiables à grande échelle ou des modifications chirurgicales dans le code Clojure : avant de lire un fichier très volumineux (utilisez :ls pour vous orienter), lors de l'extraction de code vers un nouveau namespace, lors de la résolution de problèmes de déclaration, ou lors de la fusion de sources CLJ et CLJS en un seul fichier CLJC. Déclencheurs typiques : "extraire des formes", "corriger les déclarations", "cljc-merge", "ls-deps", ou préparation d'un fichier pour extraction.

Ce qui est inclus

• Scripts/CLI : commandes basées sur babashka exposant des opérations comme :extract, :fix-declares, :ls, :ls-deps, :topo, :mv, :rename-ns, :cljc-merge, :cljc-split, :cljc-add-require, :cljc-analyze
• Tests et exemples : extraits d'utilisation documentés et flux de travail éprouvés dans le corps du SKILL.md
• Instructions : exemples de commandes étape par étape et conseils de test post-modification (lancez toujours des tests après :extract!).

Agents compatibles

Les agents capables d'exécuter des CLI locaux et des commandes shell (Claude Code, agents d'automatisation locaux, scripts CI) en bénéficieront le plus. L'outil nécessite un environnement POSIX avec babashka installé.