untangle-codebase — скилл
Скилл запускает полный рефакторинг, после которого агентам проще читать код: ищет скрытые связи и лишние зависимости.
- 1 149 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Скилл редактирует много файлов, а при выборе дополнений удаляет комментарии и тесты.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/untangle-codebaseОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Скилл редактирует много файлов, а при выборе дополнений удаляет комментарии и тесты.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
untangle-codebase ставит агенту цель довести рефакторинг всей кодовой базы до конца за один проход. Смысл в том, чтобы агенты читали меньше на каждую правку, реже ломали код незаметно и быстрее искали причины ошибок. Скилл запускается вручную, автоматически модель его не вызывает, и принимает необязательный аргумент с областью или заботой. Работа идет в четыре шага. Сначала агент спрашивает, нужны ли дополнения: удаление комментариев, которые только повторяют код, и удаление тестов, которые не поймали бы настоящую ошибку. Затем он составляет перечень проблем без правок, спрашивая, должны ли части меняться вместе. Ошибок три рода: скрытые связи (копии логики, неявный порядок вызовов), лишние связи (опора на чужие внутренности, зависимость стабильного от изменчивого) и избыточность (обертки, неиспользуемые точки расширения, мертвый код). Отдельно перечисляются частные случаи, например `if` под одно значение, проглоченное исключение или отключенный тест. Потом агент проектирует исправления с первых принципов, ища одно решение за несколькими проблемами, и выполняет их все. Результат записывается в журнал решений.
Для кого. Разработчикам, которые отдают код агентам и хотят заранее привести структуру в порядок, чтобы правки стоили меньше токенов и ломали меньше.
Подходит, если
- Агенты на этом проекте часто ломают соседний код, потому что связи между частями нигде не видны.
- Нужно сократить число токенов, которые уходят на поиск нужных файлов.
- Накопились копии логики и обертки, и их нужно собрать в общий вид.
- Тесты и комментарии стали шумом, и надо убрать то, что не ловит ошибок.
- Перед большим периодом работы агентов нужен единый разбор структуры.
Не подходит, если
- Нужна точечная правка одного файла: скилл рассчитан на проход по всей кодовой базе.
- В проекте нет тестов и контроля версий: большой рефакторинг без страховки опасен.
- Код чужой и менять его нельзя.
Пример запроса к агенту
/untangle-codebase сфокусируйся на слое доступа к данным. Дополнения: убрать комментарии, которые пересказывают код.Ограничения
Скилл меняет много файлов за один проход, поэтому запускайте его на отдельной ветке и проверьте результат тестами и просмотром диффа. Он может удалять комментарии и тесты, если вы выберете эти дополнения, перед этим внимательно читайте их описание. Вызывается только вручную, самостоятельно модель его не запускает. В репозитории один скилл, остальных нет. Результат зависит от размера проекта и модели.
Как отключить. Удалите папку скилла из `~/.claude/skills/` или выполните удаление плагина `untangle-codebase@caldo-skills` в Claude Code.
Частые вопросы
Когда скилл запускается?
Только вручную, например командой `/untangle-codebase`. Автоматически модель его не вызывает.
Что он считает проблемой?
Три рода: скрытые связи, лишние связи и избыточность, а также частные случаи вроде `if` под одно значение.
Можно ли ограничить область?
Да, через необязательный аргумент с областью или заботой.
Что за дополнения он предлагает?
Удаление комментариев, повторяющих код, и тестов, которые не поймали бы настоящую ошибку. Выбор за вами.
Какие агенты подходят?
Любые, где работает skills CLI: Claude Code, Cursor, Codex и другие.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыСкилл чистки кода после агентов: находит лишние тесты, самопроверки и запасные ветки и удаляет их, сохраняя поведение
Скилл ищет в коде лишние абстракции и дубли состояния и убирает безопасно, по доказательствам, одним срезом за раз.
Скилл /improve: сильная модель проверяет репозиторий и пишет самодостаточные планы правок, а исполнение отдаете более дешевой модели
14 скиллов, которые находят пробелы в задаче до кода: интервью, план, проверка допущений и доказательство исправления бага
Скилл находит в коде мусор от ИИ-агентов: дубли хелперов, пустые абстракции, слабые тесты. Чистит по одному шаблону за коммит.
Скилл автономной итерации для агента: правка, проверка, откат неудачных изменений и повтор цикла к заданной метрике
Коротко о README
README коротко описывает репозиторий как маркетплейс плагинов Claude Code от Caldo с одним скиллом. Установка командой `npx skills add`, лицензия MIT.