improve · owainlewis — скилл для Claude Code: рефакторинг без смены поведения
Упрощает существующий код, не меняя то, что он делает. Пригодится, когда надо убрать дубли, мёртвый код или лишние абстракции.
npx skills add owainlewis/blueprint --skill improve -a claude-codeЧто делает improve
Скилл improve берёт цель из запроса, текущего диффа или недавно изменённых файлов. Дальше он читает код, тесты и окружение и формулирует, какое поведение трогать нельзя. Если на это поведение тестов нет, скилл сначала добавляет точечное покрытие, прогоняет его на неизменённом коде и коммитит отдельно. Только после этого начинается правка.
Улучшения делаются удалением, дедупликацией, переименованием, упрощением, выделением или встраиванием. Публичные интерфейсы, формы данных, ошибки и то, что видит пользователь, остаются прежними, пока вы сами не попросите их поменять. В конце скилл прогоняет тесты и проверки, которые покрывают затронутое поведение, и отчитывается: что стало проще, что сохранилось, чем это подтверждено.
Границы жёсткие: никакого нового продуктового скоупа и попутной уборки постороннего. Лучше несколько понятных правок, чем широкий рерайт. Если поведение нечем проверить автоматически, скилл скажет об этом прямо и назовёт другой способ убедиться — это повод проверить, есть ли у вас вообще тесты на этот участок.
Какие задачи решает
- убрать дублирование в нескольких функциях
- вычистить мёртвый код перед релизом
- переименовать переменные и функции так, чтобы читалось с первого раза
- снять лишний слой абстракции, который только мешает
- добавить тесты на поведение, которое собираешься рефакторить
Примеры запросов агенту
- improve: упрости
src/parser.ts, поведение не меняй - improve: убери дублирование в модуле отчётов, тесты должны остаться зелёными
- improve: пройдись по текущему диффу и убери мёртвый код
Как установить improve
1Через Skills CLI (Vercel)
npx skills add owainlewis/blueprint --skill improve -a claude-code2Вручную: положить файлы
~/.claude/skills/improve/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/improve/
1Через Skills CLI (Vercel)
npx skills add owainlewis/blueprint --skill improve -a codex2Вручную: положить файлы
.agents/skills/improve/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add owainlewis/blueprint --skill improve -a cursor2Вручную: положить файлы
.cursor/skills/improve/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install owainlewis/blueprint improve2Вручную: положить файлы
.github/skills/improve/SKILL.md1Через Skills CLI (Vercel)
npx skills add owainlewis/blueprint --skill improve -a gemini-cli2Командой платформы
gemini skills install https://github.com/owainlewis/blueprint --path skills/improveВручную: положить файлы
.devin/skills/improve/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add owainlewis/blueprint --skill improve -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Из того же набора4
Другие версии improve
Похожие
Рядом в теме «Код-ревью и рефакторинг»
Всё по теме «Код-ревью и рефакторинг» →Вопросы о improve
Как установить improve в Claude?
Выполните npx skills add owainlewis/blueprint --skill improve -a claude-code. Скилл окажется в ~/.claude/skills/improve/SKILL.md.
Что делает improve?
Делает существующий код понятнее, не меняя его поведение: упрощает структуру, убирает дубли и мёртвый код, правит имена и лишние абстракции.
Меняет ли improve публичные интерфейсы?
Нет, если вы не попросите об этом прямо. Публичные интерфейсы, формы данных, ошибки и видимое пользователю поведение сохраняются.
Исходный текст
SKILL.md · MIT
--- name: improve description: "Makes existing code easier to understand without changing behavior. Use to simplify structure, remove duplication or dead code, improve names, or remove unnecessary abstractions." user-invocable: true argument-hint: "[code, files, diff, branch, or improvement focus]" disable-model-invocation: true --- # Improve Make code easier to understand without changing what it does. Reduce the layers a reader must trace and the hidden state they must remember. ## Process 1. Identify the target from the request, current diff, or recently changed code. 2. Read the target, its tests, and relevant surrounding code. State the behavior that must not change. 3. If that behavior lacks tests, add focused coverage and run it against the unchanged code. Commit the passing test-only change before refactoring. If automated tests cannot exercise the behavior, explain why and give other evidence. 4. Find unnecessary complexity, duplication, dead code, weak names, awkward boundaries, and abstractions that cost more than they help. 5. Make focused improvements by deleting, deduplicating, renaming, simplifying, extracting, or inlining. 6. Preserve public interfaces, data shapes, errors, and user-visible behavior unless the user explicitly asks to change them. 7. Run tests and checks that cover behavior the refactor can affect. Report what improved, what behavior was preserved, and the evidence. ## Return State what became simpler, what behavior stayed the same, and which checks prove it. Name any behavior that remains unverified. ## Boundaries - Do not add product scope or absorb unrelated cleanup. - Prefer a few clear edits over a broad rewrite. - Preserve behavior even when a redesign would be easier.
© owainlewis · MIT · owainlewis/blueprint