Разбивка Terraform на модули
Выносит ресурсы из монолитной конфигурации Terraform в модуль с типизированным интерфейсом и переносит state через блоки moved или terraform state mv без пересоздания. Для случаев, когда корневая конфигурация разрослась или повторяется.
refactor-module- Автор
- HashiCorp
- Источник
- hashicorp/agent-skills/plugins/terraform/skills/refactor-module @ 5e30fa5
- Лицензия
- MPL-2.0
Об этом скилле
Что делает
Скилл выносит ресурсы из монолитной конфигурации Terraform в модуль так, чтобы их не пришлось удалять и создавать заново. На входе — source_directory, module_name, abstraction_level (simple, intermediate или advanced), preserve_state и target_registry, дальше работа идёт в шесть шагов.
Анализ группирует ресурсы по назначению, находит повторяющиеся блоки и строит карту зависимостей. Проектирование задаёт контракт модуля: типизированные переменные, объекты для связанных значений, правила validation, выходные значения. Внутрь уходят тесно связанные ресурсы с общим жизненным циклом; теги, мониторинг и настройки провайдера остаются снаружи. Когда код переписан, начинается перенос state: сначала terraform state list и terraform show -json, затем блоки moved (Terraform 1.1 и новее) или команды terraform state mv для старых версий. Скилл предупреждает, что в state секреты лежат открытым текстом и в логи их выводить нельзя. README модуля пишется по шаблону с таблицами входов и выходов, а тесты скилл передаёт скиллу terraform-test.
В конце — три приёма рефакторинга (группировка, слои, композиция), типичные ошибки вроде интерфейса map(map(any)) и модулей, которые ссылаются друг на друга напрямую, и чек-лист готовности, последний пункт которого — пустой план после рефакторинга. В папке только SKILL.md.
Когда включать и когда не надо
Когда корневая конфигурация разрослась в один длинный main.tf, когда одни и те же ресурсы копируются между окружениями или перед публикацией кода в реестр модулей.
Скиллу нужен доступ на чтение к текущему state: адреса ресурсов он берёт из terraform state list. Для нового модуля с нуля хватит скилла о стиле кода.
Как поставить и вызвать
Этот скилл мы не копируем: его файлы под MPL-2.0, файловой копилефт-лицензией, которой нет среди тех, под которыми мы копируем. Ставьте его из репозитория HashiCorp по кнопке к исходнику: один скилл — npx skills add hashicorp/agent-skills/plugins/terraform/skills/refactor-module, или весь плагин terraform — в Claude Code claude plugin marketplace add hashicorp/agent-skills и claude plugin install terraform@hashicorp. В Codex: codex plugin marketplace add hashicorp/agent-skills, затем поставьте terraform через /plugins и начните новую сессию. В Claude Code скилл из плагина может появиться как /terraform:refactor-module.
- Claude Code:
/refactor-moduleили попросить скилл по имени. - Codex:
$refactor-module. - Cursor: наберите
/в чате Agent и выберитеrefactor-module.
Пример: /refactor-module Перенеси VPC, подсети и internet gateway из main.tf в modules/vpc, сохрани state через блоки moved и покажи план.
Чем отличается от похожих
Безопасный рефакторинг применяет то же правило — меняется структура, а не поведение — к коду приложения: сначала тесты, фиксирующие текущее поведение, потом по одному механическому шагу на коммит и прогон тестов после каждого. Здесь доказательство другое: блоки moved и план без изменений. Стиль кода Terraform и Azure Verified Modules в Terraform — наборы правил, на которые скилл ссылается для самого модуля, а Тесты Terraform отвечает за тесты, которых он требует.
Установка
Скилл не скопирован в каталог: его лицензия разрешает копию только на тех же условиях, а под такими лицензиями мы в каталог не копируем. Установите его из репозитория автора.
Скилл написан на английском — агент поймёт его и ответит вам по-русски.
Подключить через AnyModel API
Скилл работает на той модели, которую использует агент. Подключите Claude Code, Codex или Cursor к AnyModel и запускайте его на Claude, GPT, Gemini и других моделях по одному ключу — оплата за токены, без подписки.
AnyModel