Terraform

Terraform 基础设施配置调试与重构助手

安装使用

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

帮我安装这个 AI Skill:Terraform。
它的用途是:Terraform 基础设施配置调试与重构助手
完整的 Skill 内容见:https://321skill.com/skills/terraform-x-8/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

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

使用示例

'我的terraform apply报错“Error: Error locking state: Error acquiring the state lock”,如何解决?'它会分析是后端锁冲突还是网络问题,给出依次执行 `terraform force-unlock` 并检查 DynamoDB 锁表的方法。或者

对AI说:'帮我将这个aws_instance从旧模块迁移到新模块,并确保不销毁重建。'它会提供完整的 `terraform state mv` 命令和状态备份建议。

介绍

解决 Terraform 使用过程中的核心痛点:HCL 代码编写与审查、plan/apply 失败诊断、状态文件异常处理(锁卡住、丢失、损坏)、资源重命名/导入/跨模块迁移、provider 版本锁定与升级、for_each 依赖未知值导致失败、以及 CI/CD 中 plan-on-PR、apply-on-merge、漂移检测、策略门禁等自动化流程的搭建与排错。覆盖 OpenTofu、tfstate、backends、workspaces 等基础设施即代码场景。

使用方法:在对话中直接粘贴 Terraform 代码、错误日志或描述问题,Skill 会分析根因、给出修复建议、重构代码或执行状态操作。例如,对 AI 说“terraform plan 显示永久 diff 且 forces replacement,如何排查?”它会逐层检查资源属性变化、生命周期设置、provider 版本差异,并给出避免强制替换的修改方案。

适合运维工程师、运维开发、SRE 等日常使用 Terraform 管理基础设施的人员,也适合需要审查 IaC 代码的 DevOps 团队。无需额外配置,只需在支持该 Skill 的 AI 平台(如 Claude、Cursor)中启用即可。

注意事项:该 Skill 聚焦于 Terraform 配置和状态层面的调试与重构,不适用于选择云服务架构(如选 AWS 还是 GCP),也不适用于编写业务逻辑代码。对于初创团队,建议先熟悉 Terraform 基础后再使用本 Skill 解决复杂问题。

核心特点

不同于通用 IaC 辅助工具,本 Skill 深入 Terraform 状态手术、provider 锁定、版本迁移等高级场景,且原生支持 OpenTofu,能处理从 plan 失败到状态恢复的全链路问题。

注意事项

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

常见问题

如何处理 terraform plan 总是显示漂移?

检查 resources 是否有生命周期 ignore_changes,或数据源中使用了动态值(如 timestamp),尝试使用 `terraform refresh` 同步状态后重新 plan。

状态锁卡住了怎么办?

执行 `terraform force-unlock <lock_id>` 强制解锁,或检查后端(如 S3 DynamoDB)中的锁记录手动删除。

给 AI 助手的安装指引

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

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