Code Refactor

Refactoring disciplinato di rename/replace multi-file con guardrail per casi limite e API breaking

di mhattingpete · mhattingpete/claude-skills-marketplace

Promosso ★ 8.0/10

Code Refactor — Refactoring disciplinato di rename/replace multi-file con guardrail per casi limite e API breaking

Cosa fa

Una skill di refactoring che guida Claude attraverso un loop find-analyze-inform-execute-verify-test per modifiche di codice massive come la ridenominazione di identificatori, la sostituzione di pattern deprecati e l'aggiornamento di chiamate API. Si attiva quando un utente chiede di rinominare una variabile/funzione tra file, sostituire tutte le istanze di un pattern o apportare modifiche coerenti in più posizioni. Per 1-9 file utilizza Grep+Edit nativo; per 10+ file delega a un runtime di esecuzione codice Python per risparmiare token.

Rapporto di test

Costruiti due progetti JS identici di 3 file e eseguito lo stesso compito: rinominare getUserData -> fetchUserData. La BASELINE (sostituzione globale ingenua) ha mutato tutte le 7 occorrenze, inclusa la stringa letterale `const label = "getUserData"` e `console.log('getUserData called')`. L'esecuzione della SKILL ha seguito il loop find->analyze->execute->verify del corpo e le sue regole "Strings/comments: ask if should update" / "exported APIs: warn of breaking changes": ha rinominato solo i 3 siti identificatori genuini (def, import, call) più il commento descrittivo, e ha lasciato intatti la stringa letterale legacy e il messaggio di log. Verificato che api.code_transform.rename_identifier referenziato esiste (raw fetch HTTP 200); nessun security smell (no curl|sh, base64 o esfiltrazione). La modalità nativa è standalone; la modalità di esecuzione dipende da un runtime esterno non incluso nella directory della skill.

Testato il: 2026-07-21 · Claude Code 2.x (agent harness)

Installazione

git clone --depth 1 https://github.com/mhattingpete/claude-skills-marketplace.git /tmp/code-refactor-src
mkdir -p ~/.claude/skills
cp -R /tmp/code-refactor-src/code-operations-plugin/skills/code-refactor ~/.claude/skills/code-refactor
# Native mode (1-9 files) is self-contained: uses built-in Grep + Edit tools, no extra deps.
# Execution mode (10+ files) additionally needs the repo's execution-runtime/api/ package
#   (code_transform.py etc.) importable on PYTHONPATH via the companion `code-execution` skill.
#   That runtime is NOT copied by the command above; only native mode works out of the box.

Comandi e prompt di esempio

/code-refactorRefactoring disciplinato di rename/replace multi-file con guardrail per casi limite e API breaking

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

Rename this function across every file in the repo
Replace all deprecated API calls with the new method
Update this pattern consistently in all locations

Rapporto completo →