К основному содержанию
скилл CX Codex

principle-migrate-callers-then-delete-legacy-apis: скилл Claude Code

Скилл требует сразу переводить вызовы на новый внутренний API и удалять старый код без переходных слоёв совместимости.

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add backnotprop/pstack --skill principle-migrate-callers-then-delete-legacy-apis -a claude-code
Открыть на GitHub

Что делает principle-migrate-callers-then-delete-legacy-apis

Скилл задаёт строгое правило для рефакторинга: при вводе нового внутреннего API нужно сразу переписать все места его вызова. Старый интерфейс удаляется в той же волне изменений, без сохранения промежуточных адаптеров и временных прослоек.

Вместе с кодом обновляются тесты. Агент переписывает проверки под новый контракт и удаляет старые тесты, которые защищали только детали прежней реализации. Это предотвратит накопление мёртвого кода.

Правило сломает работу внешних интеграций, поэтому его нельзя применять в публичных библиотеках. Подход подходит только для внутренних интерфейсов проекта, где команда готова принять скоординированные ломающие изменения ради упрощения архитектуры.

Какие задачи решает

  • избавиться от временных слоёв совместимости при рефакторинге
  • перевести вызовы со старого внутреннего API на новый
  • удалить устаревшие тесты деталей реализации
  • провести скоординированные ломающие изменения в одной ветке

Примеры запросов агенту

  • Внедряем новый API для сервиса пользователей, обнови вызовы и удали старый метод без адаптеров.
  • Перепиши внутренний клиент базы данных и сразу удали устаревший контракт вместе со старыми тестами.

Как установить principle-migrate-callers-then-delete-legacy-apis

1Через Skills CLI (Vercel)

npx skills add backnotprop/pstack --skill principle-migrate-callers-then-delete-legacy-apis -a claude-code

2Вручную: положить файлы

~/.claude/skills/principle-migrate-callers-then-delete-legacy-apis/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/principle-migrate-callers-then-delete-legacy-apis/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Из того же набора44

principle-boundary-discipline Скилл-правило для ИИ-агента: проверки и обработка ошибок держатся на границах системы, внутри — доверие типам и чистые функции. CX Codex +1 5 100установок principle-sequence-verifiable-units Скилл учит агента разбивать миграции и массовые правки на мелкие шаги с проверкой каждого. Помогает собирать понятные цепочки коммитов для ревью. CX Codex +1 5 100установок principle-test-behavior-not-implementation Правило для тестов: проверять то, что видит вызывающий код, и не цепляться за внутренности. Помогает отличить тест, который ловит баг, от зелёной пустышки. CX Codex +1 5 200установок principle-minimize-reader-load Скилл помогает найти лишние слои абстракции и спрятанное состояние, которое замедляет понимание кода. Применяй при ревью сложных участков, когда трудно проследить логику. CX Codex +1 5 200установок principle-model-the-domain Помогает описывать предметную область через структуры данных, а не разрастающиеся условия. Нужен для логики состояний и повторяющихся правил формы данных. CX Codex +1 5 200установок principle-redesign-from-first-principles Скилл учит агента не прикручивать новые требования к готовому дизайну, а перестраивать его так, будто требование было с самого начала. Пригодится, когда правка затрагивает несколько файлов и связей. CX Codex +1 5 200установок principle-never-block-on-the-human Скилл запрещает агенту останавливаться и спрашивать разрешение на обратимые изменения в коде. Пригодится для автономного кодинга без постоянного ожидания человека. CX Codex +1 5 200установок principle-build-the-lever Скилл требует от агента не править файлы руками, а собрать codemod, скрипт или генератор, который сделает ту же работу и который можно перезапустить. CX Codex +1 5 200установок

Похожие

working-with-legacy-code wondelai Скилл для работы с кодом без тестов: помогает поставить классы под тесты, зафиксировать текущее поведение и менять код шаг за шагом. CX Codex +1 3 300установок code-refactoring-refactor-clean sickn33 Скилл анализирует запахи кода и готовит пошаговый план рефакторинга по принципам SOLID. Пригодится при разборе запутанных модулей перед добавлением новых функций. CX Codex +1 1 200установок refactoring-specialist VoltAgent Community Находит кодовые запахи, разбивает громоздкие методы и устраняет дублирование без изменения поведения программы. Пригодится при разборе легаси-кода и подготовке тестов. 784установок migrate-static-to-wrapper dotnet Меняет статические вызовы в C# на инжектируемые абстракции: DateTime.UtcNow на TimeProvider, File.* на IFileSystem. Работает в границах одного файла, проекта или неймспейса. CX Codex +1 3 300установок grepai-trace-callers yoanbernabeu Скилл учит агента искать все места в коде, откуда вызывается конкретная функция. Пригодится перед переименованием или сменой сигнатуры. CX Codex +1 784установок solid ramziddin Скилл внедряет в работу ассистента инженерные стандарты: цикл TDD, принципы SOLID и строгие правила чистоты кода. Пригодится при проектировании архитектуры и рефакторинге. CX Codex +1 3 500установок

Рядом в теме «Код-ревью и рефакторинг»

Всё по теме «Код-ревью и рефакторинг» →

Вопросы о principle-migrate-callers-then-delete-legacy-apis

Как установить principle-migrate-callers-then-delete-legacy-apis в Claude Code?

Выполните в терминале команду npx skills add backnotprop/pstack --skill principle-migrate-callers-then-delete-legacy-apis -a claude-code.

Что делает этот скилл?

Он инструктирует агента сразу мигрировать все места вызова на новый внутренний интерфейс и удалять старый API, не оставляя прослоек обратной совместимости.

Когда можно применять это правило?

Его применяют, когда у системы нет внешних пользователей, зависящих от обратной совместимости, а проект готов к скоординированным ломающим изменениям ради упрощения.

Исходный текст

SKILL.md · MIT
---
name: principle-migrate-callers-then-delete-legacy-apis
description: "Apply when introducing a new internal API while old callers still exist. Migrate callers and delete the old API in the same wave instead of preserving compatibility layers."
disable-model-invocation: true
---

# Migrate Callers Then Delete Legacy APIs

- Update tests to assert the new contract, and delete tests that only protect pre-refactor implementation details

**When this applies:**
- No external users depend on backward compatibility
- The project can absorb coordinated breaking changes
- The new API is part of a simplification or refactor initiative

© backnotprop · MIT · backnotprop/pstack

Смотрите также

Спонсоры проекта

Компании, которые помогают держать аналитику открытой