面向 AI Agent 的 Terraform & OpenTofu 技能 (Skill)

这是一套专为 AI 编码 Agent（如 Claude Code、Cursor、Copilot、Gemini CLI、OpenCode、Codex、Kiro 等）设计的 Terraform 和 OpenTofu 最佳实践技能包。它能协助 Agent 进行代码测试、模块结构化、配置 CI/CD 以及编写生产级基础设施代码。

AWS、Azure 和 GCP 均为一级支持。虽然示例中默认以 AWS 为主，但后端、认证、安全和资源方面的指导原则在三大云平台均通用——你可以询问任何模式对应的 Azure 或 GCP 版本，该技能包会自动进行映射转换。

本技能包提供的功能

测试框架

• 原生测试与 Terratest 的决策矩阵
• 测试工作流（静态、集成、E2E）
• 示例与最佳实践

模块开发

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

状态管理 (State Management)

• 远程后端 (S3, Azure, GCS, Terraform Cloud)
• 加锁与安全性
• 多团队状态隔离
• 迁移与恢复流程

CI/CD 集成

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

安全与合规

• Trivy 和 Checkov 集成
• Policy-as-code 模式
• 合规扫描工作流

快速参考

• 决策流程图
• 常用模式（推荐做法 vs 不推荐做法）
• 速查表 (Cheat sheets)

安装

通过 antonbabenko/agent-plugins 市场安装（terraform-skill 已列为其中的外部插件）。请勿将 antonbabenko/terraform-skill 作为独立市场添加，因为两者使用相同的市场名称，会导致冲突。

快速安装（适用于任何 Agent）

适用于任何兼容 Agent Skills 的工具：

npx skills add https://github.com/antonbabenko/terraform-skill

各宿主环境安装说明

Claude Code

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

Gemini CLI

gemini extensions install https://github.com/antonbabenko/terraform-skill

通过 gemini extensions update terraform-skill 进行更新。

Cursor

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

Cursor 会自动发现 .agents/skills/ 和 .cursor/skills/ 目录下的技能。

Copilot

/plugin install https://github.com/antonbabenko/terraform-skill
# 或者
git clone https://github.com/antonbabenko/terraform-skill.git ~/.copilot/skills/terraform-skill

Copilot 会自动发现 .copilot/skills/ 目录下的技能。

OpenCode

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

OpenCode 会自动发现 .agents/skills/、.opencode/skills/ 和 .claude/skills/ 目录下的技能。

Codex (OpenAI)

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

Codex 会自动发现 ~/.agents/skills/ 和 .agents/skills/ 目录下的技能。通过 cd ~/.agents/skills/terraform-skill && git pull 进行更新。

如需通过托管方式安装 Codex 插件，请使用 antonbabenko/agent-plugins 市场（执行 codex plugin marketplace add antonbabenko/agent-plugins，然后安装 terraform-skill）。请勿将 antonbabenko/terraform-skill 作为独立市场添加，否则会与 agent-plugins 发生名称冲突。

Kiro

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

Kiro 会自动发现 .kiro/skills/（工作区级别）和 ~/.kiro/skills/（全局级别）下的技能。

Antigravity

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

通过 cd ~/.antigravity/skills/terraform-skill && git pull 进行更新。

Kiro (Power 模式)

本仓库同时也是一个 Kiro Power（包含根目录 POWER.md + 可选的 mcp.json）。在 Kiro 中：进入 Powers 面板 → "Add power from GitHub"，然后粘贴：

https://github.com/antonbabenko/terraform-skill

当触发关键词（如 "terraform"、"opentofu"、"state"、"modules"）时，Kiro 会自动激活该 Power。安装它还会注册可选的只读 HashiCorp terraform-mcp-server（通过 mcp.json），位于 ~/.kiro/settings/mcp.json 的 Powers 部分——即便不配置此项，指南功能依然有效。POWER.md 由 skills/terraform-skill/SKILL.md 生成；技能内容是共享的，不会产生冗余。

手动安装（本地克隆并软链接）

git clone https://github.com/antonbabenko/terraform-skill
mkdir -p ~/.claude/plugins
ln -s "$(pwd)/terraform-skill" ~/.claude/plugins/terraform-skill

Claude Code 会在下次启动时自动发现位于 skills/terraform-skill/SKILL.md 的技能。对本地克隆版本的修改会被即时识别。