Стиль кода Terraform
Делает Terraform-код по стайлгайду HashiCorp: стандартные файлы, форматирование, имена, типизированные переменные, for_each вместо count, закреплённые версии, секреты вне state. Для случаев, когда агент пишет или проверяет HCL.
terraform-style-guide- Автор
- HashiCorp
- Источник
- hashicorp/agent-skills/plugins/terraform/skills/terraform-style-guide @ 5e30fa5
- Лицензия
- MPL-2.0
Об этом скилле
Что делает
Скилл превращает руководство HashiCorp по стилю Terraform в правила, по которым агент пишет и проверяет HCL. Код раскладывается по стандартным файлам: terraform.tf, providers.tf, main.tf, variables.tf, outputs.tf, locals.tf. Форматирование — отступ в два пробела, выровненные знаки =, метааргументы в начале блока, lifecycle в конце. Имена — строчными через подчёркивание, в единственном числе, без типа ресурса, а для единственного ресурса — main. У каждой переменной обязательны type и description, у каждого выходного значения (output) — description; for_each предпочтительнее count, а count остаётся для ресурсов «есть или нет». State, .terraform/ и файлы планов в git не попадают, .terraform.lock.hcl — попадает.
SECURITY.md в папке добавляет настройки по умолчанию: шифрование данных, приватные сети, минимальные права в группах безопасности, логирование. И задаёт порядок для секретов. Сначала — встроенная интеграция ресурса с менеджером секретов, например manage_master_user_password у RDS; затем ephemeral-ресурс, который передаёт значение в атрибут только для записи _wo (с Terraform 1.11); обычный ресурс, оставляющий секрет в state, — только в крайнем случае.
В конце — чек-лист для ревью и terraform fmt -recursive с terraform validate перед коммитом; tflint, checkov и tfsec предложены как дополнительные. Примеры написаны под провайдер AWS.
Когда включать и когда не надо
Когда агент пишет новую конфигурацию или модуль, и когда нужно сверить готовые .tf-файлы с соглашениями HashiCorp.
Это чек-лист, а не сканер: ни план, ни state он не читает. Для Stacks, тестов и файлов политик в этом паке есть свои скиллы.
Как поставить и вызвать
Этот скилл мы не копируем: его файлы под MPL-2.0, файловой копилефт-лицензией, которой нет среди тех, под которыми мы копируем. Ставьте его из репозитория HashiCorp по кнопке к исходнику: один скилл — npx skills add hashicorp/agent-skills/plugins/terraform/skills/terraform-style-guide, или весь плагин terraform с 16 скиллами — в 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:terraform-style-guide.
- Claude Code:
/terraform-style-guideили попросить скилл по имени. - Codex:
$terraform-style-guide. - Cursor: наберите
/в чате Agent и выберитеterraform-style-guide.
Пример: /terraform-style-guide Напиши модуль для S3-бакета с версионированием и KMS-шифрованием, разложи по стандартным файлам.
Чем отличается от похожих
Вне этого пака скиллов по Terraform в каталоге нет. Ближе всего по роду Ревью манифестов Kubernetes: тоже чек-лист для инфраструктурного конфига, но для YAML Kubernetes, с таблицей замечаний и dry run на сервере. Azure Verified Modules в Terraform — более жёсткий набор правил MUST/SHOULD для модулей Azure, которые проходят сертификацию AVM, а Разбивка Terraform на модули опирается на этот скилл, когда задаёт стиль создаваемых модулей.
Установка
Скилл не скопирован в каталог: его лицензия разрешает копию только на тех же условиях, а под такими лицензиями мы в каталог не копируем. Установите его из репозитория автора.
Скилл написан на английском — агент поймёт его и ответит вам по-русски.
Подключить через AnyModel API
Скилл работает на той модели, которую использует агент. Подключите Claude Code, Codex или Cursor к AnyModel и запускайте его на Claude, GPT, Gemini и других моделях по одному ключу — оплата за токены, без подписки.
AnyModel