Terraform

Terraform专家,专治HCL编写、计划错误、状态管理和模块迁移等疑难杂症。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:Terraform。
它的用途是:Terraform专家,专治HCL编写、计划错误、状态管理和模块迁移等疑难杂症。
完整的 Skill 内容见:https://321skill.com/skills/terraform-x-6/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“我的 `terraform apply` 失败了,错误信息是 ‘Error: Invalid index’。请帮我分析原因并提供修复方案。” 它会解析错误上下文,指出可能是 `for_each` 或 `count` 中使用了在 apply 阶段才可知的值,并给出使用 `dynamic` 块或调整资源依赖关系的具体代码示例。或者,你可以说:“我想将几个资源从一个模块移动到另一个独立的Terraform状态文件中。” 它会为你规划安全的迁移步骤,包括使用 `terraform state rm` 和 `terraform import` 的命令序列。

介绍

这个Skill是专为Terraform基础设施即代码(IaC)工作流设计的强大助手。它旨在解决开发者和运维人员在编写、调试和管理Terraform代码时遇到的各种复杂问题,例如HCL语法错误、terraform plan/apply执行失败、状态文件(tfstate)损坏或锁定、资源漂移(drift)、模块间资源迁移,以及Provider版本管理等。

使用时,你可以直接向它描述你遇到的Terraform问题或想要实现的功能。无论是解析一个报错信息、重构一个复杂的模块,还是诊断为什么plan会显示“强制替换”(forces replacement),它都能基于其专业知识库提供详细的步骤指导、代码片段和最佳实践建议。它覆盖了从OpenTofu、后端配置、工作空间到完整的IaC代码审查等广泛主题。

它最适合日常与Terraform打交道的工程师,包括正在编写新代码、维护现有代码库、或紧急处理生产环境基础设施问题的开发者。无论是初学者遇到的语法困惑,还是资深专家面临的状态手术(state surgery)挑战,它都能提供针对性帮助。

建议在遇到具体错误或不确定如何实现某个Terraform模式时使用它,以获得最精准的指导。请注意,它专注于Terraform工具链本身和HCL语言,不涉及具体云服务(如AWS EC2实例选型)或业务架构决策,这类问题应咨询对应的云服务Skill。

核心特点

与通用编程助手不同,它深度聚焦Terraform/HCL的特定领域,能精准诊断`plan`错误、处理棘手的`tfstate`操作(如重命名、导入、状态修复)和模块重构,并提供针对OpenTofu及CI/CD集成(如plan-on-PR)的专业建议。

注意事项

不适用于选择具体的云服务或设计整体云架构,也不处理非Terraform领域的通用编程问题。

常见问题

terraform plan 报错说 provider 版本不匹配怎么办?

可以使用此Skill帮助您分析错误信息,并指导您如何正确地在配置中锁定(pin)provider版本,或进行版本升级。

如何安全地重命名一个已存在的Terraform资源?

此Skill可以指导您使用`terraform state mv`命令或通过重构代码(使用moved块)来安全地重命名资源,避免被意外销毁和重建。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/terraform-x-6/raw/index.md 读取 Terraform 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。