
de clj-surgeon24
Une boîte à outils CLI babashka pour les modifications structurelles de Clojure/ClojureScript : extraction de formes, réorganisation, renommage de namespaces, fusion/division de CLJC, et analyse des dépendances.
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.
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.
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é.
clj-surgeon est un outil CLI babashka pour le refactoring structurel de Clojure : extraction de formulaires, correction des déclarations, fusion/division de CLJC, analyse des dépendances, et plus encore. Aucun script n'est inclus — il s'agit purement d'un fichier SKILL.md documentant un outil CLI externe situé dans ~/bin/clj-surgeon. La documentation est exceptionnellement complète avec des déclencheurs clairs, des exemples de flux de travail et des résultats de tests prouvés (103 tests, 327 assertions). Aucune préoccupation de sécurité — pas d'exécution de code à distance, pas d'identifiants, pas d'appels réseau.
SKILL.md bien structuré avec une excellente qualité de documentation. Aucun script à auditer. La compétence est purement instructive — elle enseigne à un agent comment utiliser un outil CLI externe. Utile pour les environnements Clojure, mais s'adresse à un public restreint.