一、基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 正式名称 | terraform-style-guide-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/code-generation/skills/terraform-style-guide | — |
| 许可证 | MPL-2.0（Mozilla Public License 2.0） | GitHub API |
| 所属仓库整体 Stars/Forks | 736 / 106（注：该数字属整个合集仓库，不代表本技能自身热度，仅作背景参考） | GitHub API |
| 最新版本 | 无正式 release 版本号；该技能文件最近一次提交为 2026-07-09，仓库整体最近提交为 2026-07-15 | GitHub API |
| 安装方式 | npx skills add hashicorp/agent-skills/terraform/code-generation/skills/terraform-style-guide；或经 Claude Code 插件市场安装 terraform-code-generation@hashicorp |
官方 README |
二、功能介绍与亮点
本技能把 HashiCorp 官方 Terraform 风格指南（developer.hashicorp.com/terraform/language/style）直接打包成可插拔的 Agent Skill，让编码 agent 生成/审查 HCL 代码时自动遵循官方规范：标准文件组织（terraform.tf / providers.tf / main.tf / variables.tf / outputs.tf / locals.tf）、缩进对齐与代码块顺序、命名约定（小写下划线、语义化、避免冗余）、变量与输出必须含 type/description、for_each 优先于 count、版本号钉定策略，并附带一份可直接核对的代码评审清单。
核心亮点：① 纯文档模板类技能，无需任何代码执行或外部服务依赖，开箱即用；② 官方于 2026-02-02 发布，公告称与独立评测方 Tessl 合作，通过“是否带来可衡量提升”的任务型评测后才上线，而非单纯堆砌文档；③ 技能文件本身近日（2026-07-09）仍有实质性内容更新，维护活跃度在官方出品类技能中处于前列。
三、适用场景
固定分类：DevOps 与基础设施
用 Claude Code 或 Codex 编写、审查 Terraform 基础设施代码（IaC）的初中级开发者与团队，尤其是团队内部缺乏统一 HCL 风格规范、希望 agent 产出的代码不用人工二次改格式即可通过评审的场景；也适用于将本技能配套的评审清单直接用作 PR 检查项。
四、跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 官方 README 明确列出 Claude Code 为支持目标，并提供插件市场安装命令 claude plugin install terraform-code-generation@hashicorp |
| Codex | 未验证 | 公开材料（README、公告）未点名 Codex |
| OpenClaw | 未验证 | 同上，未提及 |
| Hermes Agent | 未验证 | 同上，未提及 |
五、推荐理由
HashiCorp（现 IBM 旗下）官方出品，把 Terraform 官方风格指南打包成纯模板类技能，无代码执行、无外联，安全画像达到最高档；且发布前经独立方 Tessl 任务型评测，维护活跃度高。
六、评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 9 | HashiCorp/IBM（Terraform 母公司）官方出品；所属仓库整体 736 星、106 fork（该数字属整个合集仓库，不代表本技能自身热度，仅作侧证）；官方公告 + LinkedIn 独立评测方从业者公开推荐 |
| 可用性 | 9 | 一条命令或经插件市场即可安装；文档结构完整、代码示例丰富、附评审清单；技能文件本身 8 天前仍有更新，维护活跃；无付费依赖 |
| 安全性 | 10 | 见下方安全检查清单 |
| 综合评分 | 9.3 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令与权限范围 | 无——内容为纯文档/风格指南与示例代码片段，agent 只是参照生成 HCL 文本，不执行任何 shell 命令 |
| ② 运行时联网外发 | 无——技能本身不发起任何网络请求，仅引用官方文档链接供参考 |
| ③ API Key/凭据 | 不需要——本技能本身不涉及任何鉴权或凭据存储 |
| ④ 可疑指令排查 | 已直接抓取 SKILL.md 原文核实，全文为风格规范与代码示例，未发现 prompt injection 或隐藏指令 |
| ⑤ 作者/组织信誉 | HashiCorp（现 IBM 旗下），Terraform/Vault/Packer/Consul 的官方开发商，行业头部基础设施软件公司 |
| ⑥ License | MPL-2.0，条款清晰 |
| ⑦ 最近维护 | 技能文件本身 8 天前有实质更新，仓库整体 2 天前有提交，高度活跃 |
纯提示词/模板类、无代码执行无外联，且为官方出品、完全开源可审计，满足 9-10 档最高标准，定为 10 分。
七、跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本 skill 的差异 |
|---|---|---|
| dd-apm（datadog-labs/agent-skills，Datadog 官方） | APM 监控/追踪技能 | 同为官方出品，但需安装 pup CLI 并配置 Datadog API 凭据才能使用，涉及真实 shell 命令执行与外部 API 调用，安全评级低于本技能的纯模板方案 |
| pulumi/agent-skills（Pulumi 官方） | IaC 竞品 Pulumi 的技能合集 | 官方出品但发布不久，所属仓库仅 61 星，社区讨论与独立报道明显少于 HashiCorp 此次发布 |
| elastic/agent-skills（Elastic 官方） | Elasticsearch/Kibana/可观测性技能合集 | 官方出品，仓库 533 星，但技能覆盖偏向搜索与可观测性运维排障，多数子技能需连接真实 Elastic 集群与凭据 |
| chaterm/terminal-skills（个人/社区维护） | 通用终端与云 CLI 知识集（含 Terraform 子项） | 仅 49 星，非官方权威来源，内容为通用 sysadmin 知识汇编，权威性与规范精确度不及 HashiCorp 官方风格指南 |
| terraform-skill / terrashark（个人维护） | 第三方 Terraform 辅助技能 | 均为社区个人维护，本技能则是 Terraform 官方的风格规范技能，与二者形成互补而非替代 |
核心差异化：本技能是同类 IaC 技能中少见的“官方出品 + 纯文档模板 + 零代码执行”组合，其余官方竞品（Datadog、Elastic）均需要真实凭据与命令执行，安全画像更复杂。
八、用户评价
- Maurilio Cometto（LinkedIn，个人账号，从其发文内容看参与了 HashiCorp 与评测平台 Tessl 的合作评测工作）：评价本次发布提供“可在真实任务中稳定复用的持久上下文，而非一次性生成”，并称其为“值得探索”的基础设施+agent 结合方向。
说明：该评价者身份与 HashiCorp 官方公告中提及的评测合作方（Tessl）高度相关，并非完全独立的第三方视角，供读者自行权衡；该技能目前在公开社区渠道尚无其他具名评价。
九、其他补充
hashicorp/agent-skills 仓库目前仅覆盖 Terraform 与 Packer 两条产品线（各含多个子技能，如 terraform-module-generation、terraform-provider-development、packer-builders 等），官方公告称后续将扩展至 Vault、Consul 等更多 HashiCorp 产品；本报告只针对 terraform-style-guide 这一个子技能，仓库内其余子技能各有独立定位，需要时应分别查看其文档。
十、安装使用方式
方式一：npx skills 通用安装
npx skills add hashicorp/agent-skills/terraform/code-generation/skills/terraform-style-guide方式二：Claude Code 插件市场
claude plugin marketplace add hashicorp/agent-skills
claude plugin install terraform-code-generation@hashicorp安装后注意事项：本技能为纯文档类，安装后即可生效，无需额外认证或重启；若通过插件市场安装，同一插件下还会带入同产品线的其他 Terraform 代码生成子技能，可按需选择性使用。
十一、注意事项
- 本报告推荐的是 terraform-style-guide 这一个子技能（hashicorp/agent-skills 仓库 17 个子技能之一），来源链接务必使用本报告给出的子目录级链接
- 仓库目前只覆盖 Terraform、Packer 两条产品线，尚未覆盖 Vault、Consul 等 HashiCorp 其他核心产品
- 仓库暂无正式 release 版本号，长期接口稳定性需持续关注官方 GitHub 提交记录
- Codex、OpenClaw、Hermes Agent 的兼容性在公开材料中未见可验证说明，标记为未验证
- 第八章用户评价来源与 HashiCorp 官方评测合作方高度相关，非完全独立第三方，请读者自行权衡