Terraform
Terraform专家，专治HCL编写、计划错误、状态管理等疑难杂症。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Terraform。 它的用途是：Terraform专家，专治HCL编写、计划错误、状态管理等疑难杂症。 完整的 Skill 内容见：https://321skill.com/skills/terraform-x/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'我的terraform apply失败了，错误信息是`Error: Invalid for_each argument`，这是我的main.tf代码片段……'，它会分析你的`for_each`表达式，指出是因为值在apply阶段才可知，并建议你使用`-target`先部署依赖资源，或重构代码使用`count`和`local`值。或者，
对AI说：'我想把现有的一个AWS EC2实例导入到Terraform状态中管理，该怎么做？'，它会为你生成具体的`terraform import`命令格式，并提醒你提前在代码中定义好对应的资源块。
介绍
这个Skill是专门为使用Terraform（包括OpenTofu）进行基础设施即代码（IaC）的开发者准备的深度助手。它专注于解决在编写、调试和重构Terraform配置（HCL）及模块时遇到的各种复杂问题。无论是plan或apply命令报错、状态文件（tfstate）损坏、资源漂移（drift）、for_each因未知值失败，还是进行跨模块/状态的资源迁移、状态锁定、提供者版本锁定等高级操作，它都能提供专业指导。
使用时，你可以直接向它描述你遇到的Terraform具体问题，例如粘贴错误信息、展示计划输出中的异常（如永久性差异、强制替换），或者说明你想要进行的操作（如重命名资源、导入现有资源）。它会分析上下文，提供诊断思路、排查步骤、修复命令示例以及最佳实践建议。
它非常适合需要频繁与Terraform打交道的运维工程师、DevOps工程师、平台工程师以及负责基础设施管理的后端或全栈开发人员。无论是日常开发、代码审查，还是处理线上故障，它都能成为你的得力助手。
建议在使用时，尽可能提供详细的错误日志、terraform plan的输出片段以及相关的HCL代码块，这有助于它给出更精确的解决方案。请注意，它不负责为你选择具体的云服务（如AWS EC2还是GCP Compute Engine），这类问题应咨询对应的云服务Skill。
核心特点
与通用编程助手相比，它深度聚焦于Terraform/HCL的特定领域问题，尤其擅长诊断`plan/apply`失败、处理棘手的状态文件操作（如手术式修复、漂移检测）以及设计复杂的CI/CD流水线（如plan-on-PR）。其知识覆盖从基础语法到高级状态管理的全栈Terraform难题。
注意事项
不适合用于选择构建应用所需的底层云服务或比较不同云厂商的产品特性。
常见问题
如何修复terraform state被锁定的问题？
可以尝试使用`terraform force-unlock <LOCK_ID>`命令，但需谨慎操作并确保没有其他进程正在运行。此Skill能根据你的后端类型（如S3、本地文件）提供具体的排查和解决步骤。
terraform plan显示'forces replacement'，如何避免资源被重建？
这通常是由于资源参数的不可变变更导致。Skill可以帮助你分析是哪个参数引起的，并指导你使用`lifecycle`块中的`ignore_changes`或通过重构代码（如使用`moved`块）来避免不必要的重建。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/terraform-x/raw/index.md 读取 Terraform 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/terraform-x/raw/index.md（查看排版版本）