refactor-clean · sangrokjung — команда для Claude Code: очистка кода
Команда refactor-clean ищет мёртвый код, предлагает безопасное удаление и проверяет тесты до и после каждого изменения.
MIT ★ 880 обновлён 2026-09-03
.claude/commands/refactor-clean.mdЧто делает refactor-clean
refactor-clean запускает анализ мёртвого кода с помощью knip, depcheck и ts-prune. Результаты сохраняются в .reports/dead-code-analysis.md, а найденные элементы распределяются по уровням риска: от тестов и неиспользуемых утилит до конфигурации и главных точек входа.
Команда предлагает только безопасные удаления. Перед каждым изменением она запускает полный набор тестов, применяет удаление и повторяет проверку; при ошибке изменение откатывается. Если рефакторинг затрагивает 3 файла или больше, сначала запустите /plan.
В конце команда показывает список очищенных элементов. После неё можно отдельно вызвать /code-review, /handoff-verify или /sync для проверки кода, сборки и документации.
Какие задачи решает
- найти неиспользуемые экспорты и файлы
- обнаружить лишние зависимости
- проверить TypeScript-экспорты без ссылок
- удалить мёртвый код с откатом при падении тестов
- собрать отчёт по найденным проблемам
Примеры запросов агенту
- Запусти
/refactor-cleanи найди мёртвый код в проекте. - Проверь найденные удаления тестами и убери только безопасные элементы.
- Сформируй отчёт в
.reports/dead-code-analysis.md, затем покажи очищенные файлы.
Как установить refactor-clean
Вручную: положить файлы
.claude/commands/refactor-clean.mdВызов — /refactor-clean. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/refactor-clean.mdВызов — /prompts:refactor-clean. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/refactor-clean.prompt.mdВручную: положить файлы
.gemini/commands/refactor-clean.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о refactor-clean
Как установить refactor-clean в Claude Code?
Скопируйте файл команды в .claude/commands/refactor-clean.md.
Что делает refactor-clean?
Команда ищет неиспользуемые файлы, экспорты и зависимости, формирует отчёт и удаляет одобренные элементы с проверкой тестами до и после изменения.
Когда перед refactor-clean нужен /plan?
Если рефакторинг предположительно изменит 3 файла или больше, сначала запустите /plan.
Исходный текст
refactor-clean.md · MIT
--- description: Safely identify and remove dead code with test verification --- # Refactor Clean > **참고**: 대규모 리팩토링(3파일 이상 변경 예상)은 `/plan`을 먼저 실행하세요 (Golden Principle #9: HARD-GATE). Safely identify and remove dead code with test verification: 1. Run dead code analysis tools: - knip: Find unused exports and files - depcheck: Find unused dependencies - ts-prune: Find unused TypeScript exports 2. Generate comprehensive report in .reports/dead-code-analysis.md 3. Categorize findings by severity: - SAFE: Test files, unused utilities - CAUTION: API routes, components - DANGER: Config files, main entry points 4. Propose safe deletions only 5. Before each deletion: - Run full test suite - Verify tests pass - Apply change - Re-run tests - Rollback if tests fail 6. Show summary of cleaned items Never delete code without running tests first! --- ## 다음 단계 | 리팩토링이 끝나면 | 커맨드 | |:----------------|:-------| | 코드 검사 | `/code-review` | | 빌드/테스트 검증 | `/handoff-verify` | | 문서 동기화 | `/sync` |
© sangrokjung · MIT · sangrokjung/claude-forge
Похожие слэш-команды
Все слэш-команды по теме «Код-ревью и рефакторинг» →Сначала — refactor-clean от других авторов.