🔧 HashiCorp 官方 Agent Skills — 如何在 Claude Code & Antigravity 中使用 Terraform·Packer AI

5 月 15, 2026

—

cslab

in IT Security

2026年的今天，AI若要正确理解HCL，需要一本“官方教科书”。

HashiCorp 亲自打造的 Agent Skills 正是如此。

🎯 本文涵盖内容

HashiCorp Agent Skills 诞生的原因，以及与 MCP 的区别
在 Claude Code 和 Antigravity 中安装的两种方法
包含的 Skills 列表及其用途
如何与 Terraform MCP Server 一起使用
如何验证其实际运行情况

📌 背景 — AI 为什么会“写错” Terraform HCL

如果你让 Claude 或 GPT 编写 Terraform 代码……大多数情况下它们都能运行。但问题在于。

它们的训练数据可能过时，可能不了解 HashiCorp 内部的风格指南，或者不熟悉 Provider 的最新 schema。因此，它们可能会使用已弃用的属性，或者以 HashiCorp 不推荐的模式编写代码。

HashiCorp Agent Skills 应运而生，旨在解决这一问题。它是一个基于开放格式的领域专业知识包，解决了 AI 助手在可靠执行复杂任务时缺乏特定技术上下文的根本问题。

首次发布时，它包含了 Terraform 和 Packer 的 Skills，为 AI 助手提供了插件框架架构、schema 定义和最新最佳实践等方面的专业知识。

🔍 Agent Skills 与 MCP — 有何不同？

这两个概念容易混淆，但它们的作用完全不同。

MCP 是将数据连接到 AI 的“管道”或服务器接口，而 Agent Skills 则是知识的“教科书”。两者相辅相成，结合使用可以创建强大且上下文感知的助手。

Claude Skills 提供了结构化且可重复的工作流程，而无需运行 MCP 服务器或构建自定义工具的开销。

总结如下：


类别	Agent Skills	Terraform MCP Server
作用	向 AI 注入“知识”	AI 实时调用 Registry API
执行方式	加载 SKILL.md 文件	作为独立的服务器进程运行
所需基础设施	无（仅文件）	Docker 或本地服务器
主要用途	风格指南、模式、架构	最新的 Provider 文档、Registry 搜索

—

💻 安装方法 — 基于 Claude Code

方法 1: 使用 npx skills 命令安装 (推荐)

查看所有可用 Skills 列表并安装特定 Skill 的方法如下：

# 查看可安装的 Skills 列表
npx skills add hashicorp/agent-skills --list

# 一次性安装所有 HashiCorp Skills
npx skills add hashicorp/agent-skills

# 仅安装特定 Skill（例如：Terraform 风格指南）
npx skills add hashicorp/agent-skills/terraform/code-generation/skills/terraform-style-guide

安装位置自动为 ~/.claude/skills/ 目录。Claude Code 无需重启即可立即识别。

方法 2: 使用 Claude Code 插件市场

也支持通过 Claude Code 插件市场进行安装。

# 添加 HashiCorp Marketplace
claude plugin marketplace add hashicorp/agent-skills

# 安装单个插件
claude plugin install terraform-code-generation@hashicorp
claude plugin install terraform-module-generation@hashicorp
claude plugin install terraform-provider-development@hashicorp

在 Antigravity 中安装的方法

Antigravity IDE 使用以下命令安装 Skills：

# 使用 Antigravity 专用标志
npx antigravity-awesome-skills --antigravity

# 仅选择安装 HashiCorp Skills
npx skills add hashicorp/agent-skills -a antigravity

或者，您也可以手动将 Skills 文件夹复制到 ~/.gemini/antigravity/skills/ 目录。

📦 包含的 Skills 列表

初始的 HashiCorp Agent Skills 包解决了 Terraform 和 Packer 用户面临的最常见挑战。

当前提供的主要 Skills：

Terraform 相关

terraform-code-generation — 生成 HCL 代码时遵守 HashiCorp 风格约定
terraform-module-generation — 创建可重用的模块结构
terraform-provider-development — 开发新的 Provider（基于插件框架）
terraform-style-guide — 命名规则、文件结构、格式化指南

Packer 相关

packer-template-generation — 生成 Packer 模板和 HCL2 配置

🔗 与 Terraform MCP Server 结合使用

将 Skills（知识）与 MCP Server（实时数据）结合使用会更加强大。

Terraform MCP Server 允许 AI 模型实时访问 Terraform Registry 中最新的 Provider 文档、模块和策略。这使得 AI 能够使用准确和最新的信息来生成 Terraform 配置，而不是依赖可能过时的训练数据。

如何在 Claude Code 中添加 MCP Server：

# 使用 Docker 运行 MCP Server
docker run -i --rm hashicorp/terraform-mcp-server:0.2.3

# 注册到 Claude Code
claude mcp add --transport http terraform http://localhost:8080/mcp

如果您使用 HCP Terraform Enterprise，还需要添加认证：

# 在 ~/.gemini/.env 文件中配置
TFE_ADDRESS=your_tfe_address_here
TFE_TOKEN=your_tfe_token_here

⚠️ 注意事项

Skills 描述决定触发准确性。 Skill 的 description 字段是关键。模糊的描述会导致不稳定激活，而包含明确触发短语的描述会一致地激活。自定义 Skills 时，请具体编写 description 短语。

MCP Server 仅限本地运行。 出于安全考虑，MCP Server 目前仅设计用于本地使用。请勿将凭据硬编码到代码中，而应将其作为环境变量进行管理。

Skills 与现有 CLAUDE.md 共存。 项目根目录下的 CLAUDE.md 或 .claude/commands/ 中的命令将保持不变。Skills 是新增的，不会覆盖现有设置。

✅ 总结

HashiCorp Agent Skills 是“让 AI 正确理解 Terraform 的官方教科书”。Claude Code 和 Antigravity 都可以通过一行命令 npx skills add hashicorp/agent-skills 进行安装。与 Terraform MCP Server 结合使用时，知识 (Skills) + 实时 Registry 数据 (MCP) 的组合可以生成更准确的 HCL 代码。

如果下一步您想自动化 Terraform Provider 开发，或者将 AI 整合到 Packer AMI 构建工作流中，请参考每个 Skill 的详细指南： github.com/hashicorp/agent-skills