Terraform

专精于Terraform/HCL代码编写、调试与状态管理的AI助手

安装使用

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

帮我安装这个 AI Skill:Terraform。
它的用途是:专精于Terraform/HCL代码编写、调试与状态管理的AI助手
完整的 Skill 内容见:https://321skill.com/skills/terraform-x-2/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

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

使用示例

‘我的`terraform plan`一直显示有永久性差异,即使没有修改配置也会提示要销毁并重建我的AWS安全组,这是为什么?’ 它会分析你的HCL代码和plan输出,指出可能是安全组规则使用了动态引用(如另一个资源的ID),导致Terraform无法在plan阶段完全计算,从而误判为需要替换,并提供使用`lifecycle`块或调整资源引用的解决方案。

介绍

本Skill专注于解决Terraform(及OpenTofu)基础设施即代码实践中的各类复杂问题。它能协助编写、审查和重构HCL代码与模块,诊断terraform planapply阶段的各类错误,例如永久性差异、意外销毁或“强制替换”等问题。此外,它还能指导你进行状态管理操作,如资源重命名、跨模块/状态迁移、处理状态锁死或损坏等情况。

使用方法非常直接:当你遇到任何与Terraform相关的具体问题时,只需向AI描述你的错误信息、代码片段或想要实现的操作。例如,你可以粘贴plan的错误输出,询问根因和解决方案;或者提供你的HCL代码,请求优化建议;又或者描述一个状态管理难题,如for_each因未知值而失败,寻求绕过方法。

这个Skill非常适合日常使用Terraform进行云资源管理的运维工程师、DevOps工程师、平台工程师以及涉及基础设施代码的全栈开发。无论是新手在编写代码时寻求最佳实践,还是专家在处理棘手的生产环境状态漂移或提供商版本升级,都能从中获得精准指导。

使用建议:提问时尽可能提供具体的错误信息、相关代码段及上下文(如Terraform版本、提供商版本)。对于状态操作(如terraform state mv),建议先在非生产环境测试AI给出的命令。请注意,它不负责为你选择具体的云服务(例如该用AWS的EC2还是RDS),这类问题应咨询对应的云服务Skill。

核心特点

与通用编程助手相比,它深度聚焦于Terraform/HCL领域,不仅能处理代码语法,更能解决`plan/apply`错误诊断、状态文件手术、资源漂移、提供商锁定等基础设施代码特有的运维难题,覆盖从开发到故障排查的全生命周期。

注意事项

不适用于选择具体的云服务或比较不同云厂商的产品,也不处理与Terraform无关的通用编程或系统管理问题。

常见问题

能帮我解决`terraform apply`时出现的`forces replacement`错误吗?

可以。请提供完整的错误信息和相关资源定义代码,我会帮你分析原因并提供避免不必要资源重建的修改方案。

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

可以指导你使用`terraform state mv`命令,并说明操作步骤和前后注意事项,确保状态与配置同步而不触发重建。

给 AI 助手的安装指引

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

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