Terraform 技能，适用于 Claude

为 Claude Code 提供的全面 Terraform 和 OpenTofu 最佳实践技能。即时获取关于测试策略、模块模式、CI/CD 流程以及生产就绪基础设施代码的指导。

本技能提供的内容

🧪 测试框架

• 原生测试与 Terratest 的选择决策矩阵
• 测试策略流程（静态 → 集成 → 端到端）
• 实际案例与模式

📦 模块开发

• 结构与命名规范
• 版本控制策略
• 公共与私有模块模式

🔄 CI/CD 集成

• GitHub Actions 工作流
• GitLab CI 示例
• 成本优化模式
• 合规自动化

🔒 安全与合规

• Trivy、Checkov 集成
• 策略即代码模式
• 合规扫描流程

📋 快速参考

• 决策流程图
• 常见模式（✅ 应做 vs ❌ 不应做）
• 快速查阅备忘单

安装

此插件通过 Claude Code 市场以 .claude-plugin/marketplace.json 格式分发。

Claude Code（推荐）

/plugin marketplace add antonbabenko/terraform-skill
/plugin install terraform-skill@antonbabenko

手动安装

# 克隆到 Claude skills 目录
git clone https://github.com/antonbabenko/terraform-skill ~/.claude/skills/terraform-skill

私有测试

尽管仓库是私有的，您仍可在本地进行测试：

git clone git@github.com:antonbabenko/terraform-skill.git ~/.claude/skills/terraform-skill
# Claude Code 将从本地文件系统加载

验证安装

安装完成后，尝试：

"创建一个用于 S3 存储桶的 Terraform 模块，并包含测试"

Claude 在处理 Terraform/OpenTofu 代码时会自动使用该技能。

快速入门示例

创建带测试的模块：

“创建一个用于 AWS VPC 的 Terraform 模块，并包含原生测试”

审查现有代码：

“按照最佳实践审查这段 Terraform 配置”

生成 CI/CD 工作流：

“为 Terraform 创建一个带有成本估算的 GitHub Actions 工作流”

测试策略：

“帮助我为我的模块选择原生测试还是 Terratest”

涵盖的内容

测试策略框架

决策矩阵用于：

• 何时使用原生测试（Terraform 1.6+）
• 何时使用 Terratest（基于 Go）
• 多环境测试模式

模块开发模式

• 命名规范（terraform-<PROVIDER>-<NAME>）
• 目录结构最佳实践
• 输入变量组织
• 输出值设计
• 版本约束模式
• 文档标准

CI/CD 流程

• GitHub Actions 示例
• GitLab CI 模板
• Atlantis 集成
• 成本估算（Infracost）
• 安全扫描（Trivy、Checkov）
• 合规检查

安全与合规

• 静态分析集成
• 策略即代码模式
• 秘密管理
• 状态文件安全
• 合规扫描流程

常见模式与反模式

并排展示 ✅ 应做 vs ❌ 不应做的示例，涵盖：

• 变量命名
• 资源命名
• 模块组合
• 状态管理
• 供应商配置

为什么选择本技能？

基于生产经验：

• 来自 terraform-best-practices.com 的模式
• 来自 terraform-aws-modules 的社区验证方法
• AWS Hero 在企业级 IaC 方面的专业知识
• 在 100 多个模块中的实际应用

版本特定指导：

• Terraform 1.0+ 功能
• OpenTofu 1.6+ 兼容性
• 原生测试框架（1.6+）
• 当前工具生态系统（2024–2026）

决策框架： 不仅提供“该做什么”，还提供“何时做以及为什么”，帮助您做出明智的架构决策。

需求

• Claude Code 或其他支持技能的 Claude 环境
• Terraform 1.0+ 或 OpenTofu 1.6+
• 可选：MCP Terraform 服务器，用于增强注册表集成

贡献

请参阅 CLAUDE.md 了解：

• 技能开发指南
• 内容结构理念
• 如何提出改进建议
• 测试与验证方法

问题与反馈： GitHub Issues

发布

发布基于提交信息中的约定式提交自动进行：

提交类型	版本号递增	示例
feat!: 或 BREAKING CHANGE:	主版本	1.2.3 → 2.0.0
feat:	次要版本	1.2.3 → 1.3.0
fix:	补丁版本	1.2.3 → 1.2.4
其他提交	补丁版本（默认）	1.2.3 → 1.2.4

当更改被推送到主分支时，发布将自动创建。

相关资源

官方文档

• Terraform 语言 - HashiCorp 官方文档
• Terraform 测试 - 原生测试框架
• OpenTofu 文档 - OpenTofu 官方文档
• HashiCorp 最佳实践 - 云平台最佳实践

社区资源

• Awesome Terraform
• Terraform 最佳实践 - 综合指南（本技能的基础）
• terraform-aws-modules - 生产级 AWS 模块
• Terratest - 用于 Terraform 的 Go 测试框架
• Google Cloud 最佳实践
• AWS Terraform 最佳实践

开发工具

• pre-commit-terraform - Terraform 的预提交钩子
• terraform-docs - 从 Terraform 模块生成文档
• terraform-switcher - Terraform 版本管理器
• TFLint - Terraform 静态分析工具
• Trivy - 用于 IaC 的安全扫描工具

许可与署名

许可： Apache 2.0 - 详见 LICENSE

如果您基于本技能创建衍生作品或技能，请注明：

基于 Anton Babenko 的 terraform-skill
https://github.com/antonbabenko/terraform-skill
terraform-best-practices.com | Compliance.tf

Terraform Skill 快速上手指南

Terraform Skill 是专为 Claude Code 设计的辅助工具，旨在提供 Terraform 和 OpenTofu 的最佳实践指导。它涵盖测试策略、模块开发模式、CI/CD 工作流以及生产级基础设施代码的安全合规检查。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 运行环境：已安装并配置好 Claude Code 或其他支持 Agent Skills 的 Claude 环境。
• 核心工具：
  • Terraform 版本 1.0 或更高
  • 或 OpenTofu 版本 1.6 或更高
• 可选增强：安装 MCP Terraform server 以获得更强大的注册表集成体验。

安装步骤

您可以通过 Claude Code 市场直接安装，也可以手动克隆仓库进行安装。

方式一：通过 Claude Code 市场安装（推荐）

在终端中执行以下命令添加并安装插件：

/plugin marketplace add antonbabenko/terraform-skill
/plugin install terraform-skill@antonbabenko

方式二：手动安装

如果您希望手动管理技能文件，可以将仓库克隆到 Claude 的技能目录：

git clone https://github.com/antonbabenko/terraform-skill ~/.claude/skills/terraform-skill

注意：目前该工具主要依赖 GitHub 源，若国内网络访问受限，请确保配置好网络代理或使用加速方案。

验证安装

安装完成后，您可以在 Claude Code 中尝试发送以下指令来验证技能是否生效：

"Create a Terraform module with testing for an S3 bucket"

如果安装成功，Claude 将自动调用该技能为您提供符合最佳实践的代码和指导。

基本使用

安装成功后，您无需编写额外代码，只需在对话中自然描述您的需求，Skill 会自动介入并提供专业建议。以下是几个典型的使用场景：

1. 创建带测试的模块

请求生成包含原生测试的 AWS VPC 模块：

"Create a Terraform module for AWS VPC with native tests"

2. 代码审查与优化

让 AI 根据最佳实践审查现有的配置文件：

"Review this Terraform configuration following best practices"

3. 生成 CI/CD 工作流

请求生成包含成本估算的 GitHub Actions 工作流：

"Create a GitHub Actions workflow for Terraform with cost estimation"

4. 测试策略咨询

当不确定选择何种测试框架时，寻求决策建议：

"Help me choose between native tests and Terratest for my modules"

该技能不仅提供代码片段，还会解释“为什么”这样做，帮助您在架构设计上做出更明智的决策。