Terraform
Terraform HCL编写、调试与状态管理专家
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:Terraform。 它的用途是:Terraform HCL编写、调试与状态管理专家 完整的 Skill 内容见:https://321skill.com/skills/terraform-x-5/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'terraform plan报错“forces replacement”,我想避免替换,这个资源是一个EC2实例,如何修改HCL?' 它会分析你的代码,指出哪些属性变更导致强制替换,并建议使用lifecycle ignore_changes或调整参数,同时验证修改后的plan是否消除替换。
介绍
这个技能专门解决Terraform基础设施即代码(IaC)全生命周期中的各类问题,涵盖HCL语言编写、模块调试、plan/apply失败、状态文件(tfstate)异常、资源漂移(drift)、provider版本锁定等核心场景。无论是写HCL时遇到语法错误,还是terraform plan出现永久diff、不明销毁、强制替换(forces replacement),或是state锁卡死、状态丢失、for_each依赖未知值,它都能提供诊断和修复方案。同时支持OpenTofu、后端、工作区以及基础设施代码审查。
使用时,只需在对话中描述当前遇到的Terraform问题或任务,例如“我这个plan显示永久diff,如何消除?”或“需要重命名一个资源并迁移到新模块”。技能会分析你的代码或状态,给出具体的HCL修改建议、state操作命令(如terraform state mv)、provider锁定策略,甚至指导如何配置plan-on-PR、apply-on-merge与drift检测的CI/CD流水线。
适合运维工程师、运维开发、基础设施工程师以及所有使用Terraform管理云资源的团队。尤其是那些频繁处理复杂状态操作、跨模块迁移、大版本升级或需要建立IaC最佳实践的人员。
注意:本技能专注于Terraform/OpenTofu本身的操作与调试,不涉及云服务的选择与架构设计(如选择AWS、GCP或Azure的具体服务)。如需云服务选型建议,请配合对应的云平台技能使用。
核心特点
与通用IaC调试助手不同,本技能深度覆盖Terraform特有的状态手术(state surgery)、provider锁定、drift检测及plan-on-PR等CI/CD集成,并能处理OpenTofu的兼容性问题,是Terraform全栈运维的专用工具。
注意事项
不适用于非Terraform的基础设施工具(如Ansible、Pulumi),也不提供云服务选型或架构设计建议。
常见问题
terraform plan显示永久diff怎么办?
技能会分析diff来源,常见原因包括:资源属性顺序变化、provider版本不一致、忽略的配置项(如lifecycle ignore_changes)或外部修改。它将给出具体HCL调整建议。
state锁卡住了,如何强制解锁?
技能会指导你使用terraform force-unlock命令,并检查是否有其他进程占用锁,同时建议避免在非交互环境中使用force-unlock以防止数据损坏。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/terraform-x-5/raw/index.md 读取 Terraform 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/terraform-x-5/raw/index.md(查看排版版本)