用途:引导 AI 智能体把单体式 Terraform 配置系统性重构为结构良好的模块,遵循 HashiCorp 模块设计原则与社区最佳实践。
主要能力:分析现有代码并按逻辑功能分组资源、识别重复模式与依赖关系;设计清晰的输入输出接口契约(变量与输出);进行封装与抽象;生成版本与文档;提供测试框架;规划现有状态的迁移路径。
输入参数:source_directory(必填,现有配置路径)、module_name(必填)、abstraction_level(可选,simple/intermediate/advanced,默认 intermediate)、preserve_state(必填,是否保持状态兼容)、target_registry(可选,local/private/public)。
使用方式:先分析阶段识别重构候选并评估复杂度;再进行模块设计(接口与封装策略);随后进行代码转换,将单体配置改为模块结构;接着做状态迁移,可用 terraform state list 枚举地址、terraform show -json 查看属性值,并生成 moved 块或 terraform state mv 命令;最后编写模块文档并测试。测试可参考 terraform-test 技能,使用 .tftest.hcl 文件、run 块、assert 块、mock provider 等。
适用场景:需要把重复、耦合的 Terraform 资源整理为可复用模块,或按网络、计算、数据等分组抽取模块,以及采用基础模块加环境包装、组合式小模块等模式。
限制与注意:需先理解资源依赖并具备状态检查能力;状态迁移应先在非生产环境验证,确保迁移后 terraform plan 无差异;避免过度抽象与模块间紧耦合;状态文件含明文敏感值,不可输出到日志。具体版本要求、收费与平台支持等资料未提供。