一、基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 正式名称 | terraform-stacks-hashicorp-agent-skills | 合集仓库子目录名(见下方说明) |
| 所属合集仓库 | hashicorp/agent-skills(HashiCorp 官方 Agent Skills 合集,含 Terraform、Packer 两条产品线共 17 个技能) | GitHub |
| 作者/维护者 | HashiCorp(现为 IBM 旗下),官方账号 hashicorp 发布 |
GitHub |
| 来源链接 | https://github.com/hashicorp/agent-skills/tree/main/terraform/module-generation/skills/terraform-stacks | — |
| 许可证 | MPL-2.0(Mozilla Public License 2.0) | GitHub API |
| 所属仓库整体 Stars/Forks | 754 / 110(注:该数字属整个合集仓库,不代表本技能自身热度,仅作背景参考) | GitHub API |
| 最新版本 | 内部 metadata 版本号 0.0.1;本技能所在目录最近一次提交为 2026-07-09 | GitHub API |
| 安装方式 | npx skills add hashicorp/agent-skills/terraform/module-generation/skills/terraform-stacks;或经 Claude Code 插件市场安装 terraform-module-generation@hashicorp |
官方 README |
二、功能介绍与亮点
本技能教 Agent 编写与调试 HashiCorp Terraform Stacks——HCP Terraform 之上的一层配置语言(.tfcomponent.hcl / .tfdeploy.hcl),用于把多个环境、区域或云账号的基础设施作为一个整体单元做声明式编排。内容覆盖 Stack 的核心概念(Component / Deployment / Stack 语言)、Provider 配置(含用 OIDC 工作负载身份取代长期静态密钥的最佳实践)、Component / Output / Locals / Removed 等区块写法,并附带 6 份专题参考文档:组件区块示例、部署区块、大型示例集、跨 Stack 引用、API 监控、故障排查。
核心亮点:① 官方发布时与独立评测方 Tessl 合作做任务型评测——评测结果显示本技能把 Agent 在 Stacks 任务上的成功率从 47% 提升到 96%(约 2 倍);② 目录内容近日(2026-07-09)仍有实质更新,且有多位不同贡献者(含 HashiCorp 员工与外部开发者)共同维护;③ 内置故障排查与 API 监控参考文档,覆盖真实部署调试场景,而不只是语法介绍。
三、适用场景
固定分类:DevOps 与基础设施
用 Claude Code 管理多环境、多区域或多云账号基础设施的 DevOps 工程师与平台团队,尤其是已经在用 HCP Terraform、需要把过去分散的 workspace 编排整合为单一声明式 Stack 的场景;也适用于团队成员不熟悉 Stack 专属 HCL 变体语法、需要 Agent 辅助生成正确 .tfcomponent.hcl / .tfdeploy.hcl 文件的场景。
四、跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 官方 README 列出 Claude Code 为支持目标,并提供插件市场安装命令 |
| Codex | 未验证 | README 列出 GitHub Copilot / Opencode / Cursor 等,未点名 Codex |
| OpenClaw | 未验证 | 同上,未提及 |
| Hermes Agent | 未验证 | 同上,未提及 |
五、推荐理由
HashiCorp(现 IBM 旗下)官方出品,把原本晦涩的 Terraform Stacks 专属语法整理成结构化的 Agent 技能,并有独立评测方数据支撑实际效果——这是目前少见的、带有量化任务成功率提升证据的基础设施类技能。
六、评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 9 | HashiCorp/IBM 官方出品;所属仓库整体 754 星、110 fork(背景参考,不计入本技能自身);独立评测方 Tessl 给出量化评测——任务成功率从 47% 提升到 96% |
| 可用性 | 8 | 一条命令或经插件市场即可安装;文档结构完整,含大量示例与故障排查参考;目录近日仍有更新;但 Stacks 功能本身依赖 HCP Terraform(非纯开源 CLI 可独立使用),需额外账号 |
| 安全性 | 8 | 见下方安全检查清单 |
| 综合评分 | 8.3 | 三项均值 |
安全检查清单:
| 检查项 | 结果 |
|---|---|
| ① Shell 命令与权限范围 | 参考文档中含 curl 示例,用于调用 HCP Terraform 官方 API 查询用户自己的部署状态与诊断信息,范围明确 |
| ② 运行时联网外发 | 仅指向 HashiCorp 官方 app.terraform.io API,用于状态查询,目标透明 |
| ③ API Key/凭据 | 使用用户自有的 HCP Terraform API Token(Bearer 认证),存储由用户自行掌控;文档同时倡导用 OIDC 动态凭据取代长期静态密钥 |
| ④ 可疑指令排查 | 已直接抓取 SKILL.md 与全部 6 份参考文档原文核实,未发现 prompt injection 或隐藏指令 |
| ⑤ 作者/组织信誉 | HashiCorp(现 IBM 旗下),Terraform 官方开发商 |
| ⑥ License | MPL-2.0,条款清晰 |
| ⑦ 最近维护 | 目录最近一次提交 2026-07-09,多位贡献者共同维护 |
含范围明确、目标透明的 API 调用,且外联对象为官方自家服务,符合 7-8 档标准,定为 8 分。
七、跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本 skill 的差异 |
|---|---|---|
| terraform-style-guide(hashicorp/agent-skills 内的另一技能) | Terraform 代码风格规范技能 | 纯文档模板、零代码执行;但只管代码格式,不涉及多环境/多区域编排能力 |
| pulumi-esc(pulumi/agent-skills,Pulumi 官方) | IaC 竞品 Pulumi 的密钥/配置集中管理技能 | 聚焦密钥与动态凭据管理,与 Terraform Stacks 面向的“多组件整体编排”是不同层面的问题 |
| Terragrunt(gruntwork-io,开源工具,非 Agent Skill) | 社区主流的 Terraform 多环境编排工具,9,700+ 星 | 通过额外的 HCL 包装层在纯开源 Terraform CLI 上实现 DRY 与多环境复用,无需 HCP Terraform 账号,但也没有官方一体化的 Stack 语言与部署可视化 |
核心差异化:本技能是目前少见的、由 IaC 工具官方厂商直接出品、专门针对其托管平台专属编排语法的 Agent 技能,且有独立量化评测数据佐证效果,而非通用 IaC 知识汇编。
八、用户评价
该技能目前在第三方社区平台尚无具名用户评价;在 GitHub 仓库 issue 区可查到一条外部开发者(quixoticmonk)就该技能文档结构提出的具体改进建议,HashiCorp 维护者已回应确认后续调整。
九、其他补充
hashicorp/agent-skills 仓库目前覆盖 Terraform 与 Packer 两条产品线,terraform-stacks 与仓库内的 terraform-style-guide 同属 Terraform 产品线下的不同子技能,功能互补而非替代;官方公告称后续将扩展至 Vault、Consul 等更多 HashiCorp 产品。
十、安装使用方式
方式一:npx skills 通用安装
npx skills add hashicorp/agent-skills/terraform/module-generation/skills/terraform-stacks
方式二:Claude Code 插件市场
claude plugin marketplace add hashicorp/agent-skills
claude plugin install terraform-module-generation@hashicorp
安装后无需重启,Agent 会在处理 .tfcomponent.hcl / .tfdeploy.hcl 相关任务时自动加载本技能;需自行准备 HCP Terraform 账号及 API Token 才能实际执行部署与状态查询相关操作。
十一、注意事项
- Terraform Stacks 是 HCP Terraform(Terraform Cloud/Enterprise)专属功能,无法在纯开源 Terraform CLI 或纯本地 state 场景下使用;需要 v1.13 及以上版本的 Terraform 才能使用 Stacks CLI 插件
- Stack 专属的 HCL 语法(
.tfcomponent.hcl/.tfdeploy.hcl)与常规 Terraform 配置文件语法存在差异,直接套用常规 Terraform 写法可能出错,需以本技能文档为准 - 目前仅验证了与 Claude Code 的兼容性,其余 Agent 生态尚未获得直接证据