Terraform
Terraform HCL 编写、调试与状态修复专家
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Terraform。 它的用途是：Terraform HCL 编写、调试与状态修复专家 完整的 Skill 内容见：https://321skill.com/skills/terraform-x-9/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'我的terraform plan显示一个永久diff，每次apply后下次plan又出现同样的diff，请帮我分析HCL和state文件找出原因。' 它会读取state和配置，对比provider版本、资源属性变化，定位到某个属性被外部系统修改或lifecycle规则缺失，然后给出修复方案，比如添加ignore_changes或调整Provider版本。
介绍
这个 Skill 专注于解决 Terraform 全生命周期中的基础设施即代码问题。它涵盖 HCL 编写与重构、plan/apply 失败诊断、状态文件手术（state surgery）、配置漂移（drift）检测、Provider 版本锁定以及跨模块资源迁移等场景。无论是 terraform plan 报错、出现永久 diff、无故 destroy 或“forces replacement”，还是状态锁卡死、state 丢失或损坏，它都能提供精准的根因分析与修复方案。
使用时，只需将 Terraform 相关的错误信息、plan 输出或状态文件内容提供给 AI，它会结合 HCL 语法、Provider 行为、backend 配置和 workspace 结构逐层分析。例如，你可以直接粘贴 terraform plan 的报错日志，或描述“for_each 依赖 apply 时才知的值”导致的失败，AI 会给出具体的 HCL 修改建议或 state 操作步骤。它也支持 OpenTofu 和 tfstate 相关操作。
适合运维工程师、运维开发人员以及需要管理基础设施的后端开发。如果你日常负责 Terraform 模块编写、CI/CD 中 plan-on-PR/apply-on-merge 的流水线搭建、漂移检测与策略门禁的配置，这个 Skill 能大幅提升排错和自动化效率。对于需要同时维护多个工作空间和状态文件的团队，它的状态合并、拆分、导入和移动能力尤为实用。
注意：此 Skill 不负责选择云服务（如该用 AWS 还是 Azure），也不生成云架构设计——这些请参考对应的云厂商 Skill。它专注于 Terraform 配置本身的质量、安全与运维。对于涉及敏感信息（如密钥）的 state 文件，建议在隔离环境中使用，并确保不会意外泄露 state 中的明文数据。
核心特点
同类 IaC 辅助工具多只提供通用代码建议，而此 Skill 专精于 Terraform 状态级操作（state surgery、drift 修复、Provider 锁定）和 HCL 特有语法陷阱（如 for_each 未知值、forces replacement），并能直接操作 OpenTofu 后端状态。
注意事项
不适用于选择云服务或设计云架构，也不适合处理非 Terraform 的 IaC 工具（如 Pulumi、CDK）。
常见问题
terraform plan 一直显示永久 diff，怎么解决？
最常见原因是 Provider 版本差异或资源属性被外部修改。将 plan 输出和 state 文件提供给 AI，它会分析 diff 的根因，建议调整 Provider 版本或使用 lifecycle 忽略特定属性。
state 锁卡住了怎么办？
可以强制解锁（terraform force-unlock），但需先确认没有其他进程正在操作。AI 会引导你安全地删除锁记录，并检查是否还有残留的锁定。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/terraform-x-9/raw/index.md 读取 Terraform 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/terraform-x-9/raw/index.md（查看排版版本）