refactoring-analysis — скилл для Claude Code: как установить
Анализирует архитектуру проекта по запахам кода Фаулера и формирует отчёт в docs/_refacs/. Помогает запланировать рефакторинг без форматирования и аудита безопасности.
npx skills add pedronauck/skills --skill refactoring-analysis -a claude-codeЧто делает refactoring-analysis
Скилл ищет проблемные участки кода, опираясь на каталог запахов Фаулера. Вместо отвлечённых теоретических замечаний он требует точных доказательств в кодовой базе и понятной пользы для поддержки. При широком охвате агент не останавливается на отметке в 50 файлов, а строит карту зависимостей и сразу фиксирует непроверенные зоны.
Для анализа связности и границ вызовов используются внутренние каталоги техник и чеклисты. Принципы SOLID и предметно-ориентированное проектирование привлекаются только к доменным моделям, обычный код этой проверке не подвергается. Итоговый план сортируется по влиянию на продукт, рискам и трудозатратам, после чего сохраняется в папку docs/_refacs/.
Инструмент намеренно игнорирует форматирование, аудит безопасности и оптимизацию производительности. Это повод проверить другие решения, если проекту требуется поиск уязвимостей или профилирование памяти.
Какие задачи решает
- найти запахи кода по методике Фаулера с оценкой рисков и затрат
- составить отчёт по архитектуре проекта в каталоге
docs/_refacs/ - спланировать рефакторинг сложных модулей без нарушения совместимости
- выявить сильную связанность компонентов и проблемные границы вызовов
Примеры запросов агенту
- Проанализируй кодовую базу на запахи кода и сохрани отчёт в docs/_refacs/
- Найди узкие места в архитектуре модулей и оцени риски рефакторинга
- Проверь зависимости и публичные границы вызовов перед рефакторингом
Как установить refactoring-analysis
1Через Skills CLI (Vercel)
npx skills add pedronauck/skills --skill refactoring-analysis -a claude-code2Вручную: положить файлы
~/.claude/skills/refactoring-analysis/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/refactoring-analysis/
1Через Skills CLI (Vercel)
npx skills add pedronauck/skills --skill refactoring-analysis -a codex2Вручную: положить файлы
.agents/skills/refactoring-analysis/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add pedronauck/skills --skill refactoring-analysis -a cursor2Вручную: положить файлы
.cursor/skills/refactoring-analysis/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install pedronauck/skills refactoring-analysis2Вручную: положить файлы
.github/skills/refactoring-analysis/SKILL.md1Через Skills CLI (Vercel)
npx skills add pedronauck/skills --skill refactoring-analysis -a gemini-cli2Командой платформы
gemini skills install https://github.com/pedronauck/skills --path skills/mine/refactoring-analysisВручную: положить файлы
.devin/skills/refactoring-analysis/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add pedronauck/skills --skill refactoring-analysis -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о refactoring-analysis
Как установить refactoring-analysis в Claude Code?
Выполните команду npx skills add pedronauck/skills --skill refactoring-analysis -a claude-code.
Что делает refactoring-analysis?
Он анализирует архитектурное здоровье проекта по каталогу запахов Фаулера, ранжирует находки по рискам и трудозатратам, а затем формирует структурированный отчёт.
Проверяет ли скилл безопасность и производительность?
Нет, эти задачи исключены из рамок проверки. Скилл также не занимается форматированием и стилем кода.
