safe-refactor — скилл для Claude Code: что делает и как установить
Ограничивает рефакторинг сохранением поведения: фиксирует проверки до правок кода, запрещает смешивать перенос структуры с новыми фичами.
npx skills add JuliusBrussee/caveman --skill safe-refactor -a claude-codeЧто делает safe-refactor
Скилл задаёт агенту чёткие рамки рефакторинга. Он требует зафиксировать проверки до внесения структурных изменений и повторить их после работы. Любые продуктовые доработки выносятся за рамки процесса, чтобы не сломать логику.
Во время работы агент переносит границы владения по одной за раз, сохраняя публичные интерфейсы, поведение при ошибках и совместимость. Промежуточные состояния кода остаются сборными и тестируемыми. Новые зависимости или конфигурации добавлять запрещено, если это не требуется для корректности.
Ставить скилл стоит, если нужно аккуратно выделить модуль или почистить структуру без риска получить скрытые регрессии.
Какие задачи решает
- выделить модуль или функцию без изменения поведения программы
- перенести границы владения кодом по одному шагу за раз
- сохранить публичные интерфейсы и сценарии сбоев при чистке кода
- проверить промежуточные состояния кодовой базы тестами
Примеры запросов агенту
- Вынеси обработку заказов в отдельный сервис через safe-refactor
- Сделай рефакторинг этого модуля, сохрани публичный интерфейс и поведение при ошибках
Как установить safe-refactor
1Через Skills CLI (Vercel)
npx skills add JuliusBrussee/caveman --skill safe-refactor -a claude-code2Вручную: положить файлы
~/.claude/skills/safe-refactor/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/safe-refactor/
1Через Skills CLI (Vercel)
npx skills add JuliusBrussee/caveman --skill safe-refactor -a codex2Вручную: положить файлы
.agents/skills/safe-refactor/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add JuliusBrussee/caveman --skill safe-refactor -a cursor2Вручную: положить файлы
.cursor/skills/safe-refactor/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install JuliusBrussee/caveman safe-refactor2Вручную: положить файлы
.github/skills/safe-refactor/SKILL.md1Через Skills CLI (Vercel)
npx skills add JuliusBrussee/caveman --skill safe-refactor -a gemini-cli2Командой платформы
gemini skills install https://github.com/JuliusBrussee/caveman --path skills/safe-refactorВручную: положить файлы
.devin/skills/safe-refactor/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add JuliusBrussee/caveman --skill safe-refactor -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
Из того же набора22
Весь набор →Похожие
Вопросы о safe-refactor
Как установить safe-refactor в Claude Code?
Выполните команду npx skills add JuliusBrussee/caveman --skill safe-refactor -a claude-code. Также можно поместить файл в ~/.claude/skills/safe-refactor/SKILL.md.
Что делает safe-refactor?
Он обязывает модель зафиксировать тесты до изменения кода, запрещает смешивать новые функции с рефакторингом и требует проверять идентичность поведения после правок.
Можно ли добавлять новые библиотеки во время работы со safe-refactor?
Скилл запрещает наращивать зависимости и конфигурации, если это не вызвано прямой необходимостью для корректности кода.
Исходный текст
SKILL.md · Apache-2.0
--- name: safe-refactor description: Restructure code while preserving behavior. Use for extraction, consolidation, ownership moves, or cleanup where verification must bracket structural edits. --- # Safe refactor Define behavior-preservation boundary and establish verification before structural edits. - Keep feature changes outside refactor. - Move one ownership boundary at a time. - Preserve public interfaces, failure behavior, ordering, and compatibility unless explicitly scoped. - Keep intermediate states buildable and testable. - Avoid dependency or configuration growth without correctness need. Run same proof after change. Stop when behavior matches and requested structure is achieved.
© JuliusBrussee · Apache-2.0 · JuliusBrussee/caveman