Terraform

专为Terraform代码编写、调试和状态管理设计的AI助手

安装使用

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

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

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

使用示例

'我的terraform plan显示一个永久性diff,并且有'forces replacement'标记,帮我分析原因并修复。' 它会检查你的HCL代码和state,识别出导致强制替换的属性变更,提供修改代码或使用lifecycle ignore_changes等解决方案。

介绍

解决什么问题:Terraform作为基础设施即代码的主流工具,在实际使用中常遇到HCL语法错误、plan/apply执行失败、意外的状态变更(永久diff、强制替换、意外destroy)、state锁死或损坏、模块和资源迁移、provider版本升级兼容性、CI/CD集成等问题。本Skill针对这些场景提供精准诊断和修复建议,帮助开发者高效处理Terraform日常运维中的痛点。

怎么用:你可以在编写或审查HCL代码时调用本Skill,它会自动分析代码结构、变量定义、资源引用关系,并给出优化建议。当terraform plan或apply报错时,将错误信息粘贴给AI,它能解析错误日志、定位根因(如资源冲突、依赖缺失、provider不兼容等),并提供修复命令。对于state操作(如重命名、导入、移动资源、解锁state),你可以描述需求,AI会生成对应的terraform state命令并验证执行结果。在CI/CD集成中,它可以帮你设计plan-on-PR、apply-on-merge、drift检测和策略门禁的流水线配置。

适合谁:主要面向运维工程师、运维开发、DevOps工程师,以及需要管理云基础设施的全栈开发者。如果你日常使用Terraform管理AWS、Azure、GCP等云资源,或正在迁移到OpenTofu,这个Skill能显著提升你的工作效率。

使用建议:建议在执行AI建议的操作前,先备份state文件和代码,特别是在涉及state surgery或批量资源迁移时。对于复杂的provider升级或跨版本迁移,请先在非生产环境测试。本Skill不负责选择云服务或设计云架构,如需相关帮助请参考对应的云服务专用Skill。

核心特点

专注于Terraform特有的HCL语法、state操作、plan/apply失败诊断、provider管理、模块迁移、CI/CD集成等场景,而非通用Infrastructure as Code或云服务选择,能精准解决Terraform用户的独家痛点。

注意事项

不适合非Terraform的基础设施编排工具(如Pulumi、CloudFormation),也不适用于选择云服务或设计云架构。

常见问题

terraform state锁卡住了怎么办?

可以尝试使用terraform force-unlock命令,或者检查是否有其他进程正在使用state。本Skill可以帮你分析锁的持有者并给出解锁建议。

如何将资源从一个模块迁移到另一个模块?

可以使用terraform state mv命令,但需要确保资源在新模块中正确定义。本Skill可以帮你生成迁移命令并验证结果。

给 AI 助手的安装指引

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

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