provider-framework-migration — скилл для Claude Code
Помогает переносить ресурсы и источники данных Terraform с Plugin SDKv2 на Plugin Framework. Разбирает настройку mux, схемы и проверку совместимости состояния.
npx skills add hashicorp/agent-skills --skill provider-framework-migration -a claude-codeЧто делает provider-framework-migration
Скилл описывает пошаговый перенос ресурсов и источников данных по одному, пока провайдер обслуживает реализации на SDKv2 и Framework через mux. Он помогает настроить сервер с terraform-plugin-mux и tf5to6server, сопоставить элементы схемы и проверить поведение ресурса до и после миграции.
Отдельное внимание уделено различию между null и нулевыми значениями, блокам, атрибуту id и чтению состояния, записанного SDKv2. До переноса предлагается подготовить acceptance-тесты и зафиксировать поведение необязательных атрибутов. Для протокола 6 Terraform CLI должен быть версии 1.0 или выше; для поддержки Terraform 0.12+ описан вариант с протоколом 5. Это ограничение важно при выборе схемы: nested attributes требуют протокола 6.
Какие задачи решает
- настроить mux для SDKv2 и Plugin Framework
- перенести схему и CRUD одного ресурса
- сопоставить
ForceNew,Defaultи блоки со схемой Framework - проверить расхождения плана из-за null и пустых значений
- проверить совместимость состояния после миграции
Примеры запросов агенту
- Настрой mux-сервер для провайдера с SDKv2 и Plugin Framework.
- Помоги перенести схему этого ресурса на Plugin Framework, сохранив блоки и атрибут
id. - Разбери расхождение плана после миграции: проверь обработку null и состояния.
Как установить provider-framework-migration
1Через Skills CLI (Vercel)
npx skills add hashicorp/agent-skills --skill provider-framework-migration -a claude-code2Вручную: положить файлы
~/.claude/skills/provider-framework-migration/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/provider-framework-migration/
1Через Skills CLI (Vercel)
npx skills add hashicorp/agent-skills --skill provider-framework-migration -a codex2Вручную: положить файлы
.agents/skills/provider-framework-migration/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add hashicorp/agent-skills --skill provider-framework-migration -a cursor2Вручную: положить файлы
.cursor/skills/provider-framework-migration/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install hashicorp/agent-skills provider-framework-migration2Вручную: положить файлы
.github/skills/provider-framework-migration/SKILL.md1Через Skills CLI (Vercel)
npx skills add hashicorp/agent-skills --skill provider-framework-migration -a gemini-cli2Командой платформы
gemini skills install https://github.com/hashicorp/agent-skills --path plugins/terraform/skills/provider-framework-migrationВручную: положить файлы
.devin/skills/provider-framework-migration/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add hashicorp/agent-skills --skill provider-framework-migration -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о provider-framework-migration
Как установить provider-framework-migration в Claude Code?
Выполните npx skills add hashicorp/agent-skills --skill provider-framework-migration -a claude-code. Файл скилла появится по пути ~/.claude/skills/provider-framework-migration/SKILL.md.
Что делает provider-framework-migration?
Помогает переносить ресурсы и источники данных Terraform с SDKv2 на Plugin Framework, настраивать mux и проверять совместимость схемы и состояния.
Что нужно для работы провайдера через протокол 6?
В описанном варианте с протоколом 6 нужен Terraform CLI версии 1.0 или выше. Для поддержки Terraform 0.12+ скилл описывает mux на протоколе 5, но тогда недоступны функции Framework, требующие протокола 6.
