1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | terrashark（项目内品牌样式为 “TerraShark”，见下方说明） | GitHub API |
| 项目自述名称 | TerraShark（README 标题：“Terraform Skill for Claude Code, Codex, Antigravity, and Gemini CLI: TerraShark”） | GitHub 页面 |
| 作者/维护者 | Lukas Niessen（主要维护者，39 次提交）；另有 2 位社区贡献者各提交 1 次；接入 Dependabot 自动依赖更新 | GitHub API |
| 来源链接 | https://github.com/LukasNiessen/terrashark | — |
| 许可证 | MIT | GitHub API |
| GitHub Stars | 301 | GitHub API |
| Forks | 21 | GitHub API |
| 最新版本 | v2.3.0（Git tag） | GitHub API |
| 安装方式 | git clone 到技能目录，或 Claude Code 插件市场一键安装 |
GitHub README |
2. 功能介绍与亮点
TerraShark 是一个面向 Terraform / OpenTofu 基础设施代码的“失败模式优先”工作流技能：它不直接让模型套用一堆参考资料，而是先强制诊断本次改动可能触发的风险类型——身份漂移（资源重构导致的意外重建）、密钥泄露、影响范围过大、CI 配置漂移、合规缺口——再按需加载对应的参考文件，最后要求输出包含假设、权衡与回滚方案的“结构化交付契约”。
亮点：
- 诊断优先：生成代码前先判断失败模式，而非直接照抄样板
- 按需加载、token 高效：核心 SKILL.md 仅约 600 token 激活成本，19 个细分参考文件按信号条件加载
- 合规映射：内置 ISO 27001、SOC 2、FedRAMP、GDPR、PCI DSS、HIPAA 等框架的控制项映射，同类技能中少见
- 可信模块优先：对 AWS/Azure/GCP/OCI/IBM 等主流云商，默认推荐带版本锁定的官方/社区可信模块，减少模型臆造资源类型
- CI 中接有 GitHub Actions 校验工作流，仓库工程化程度较高
3. 适用场景
固定分类：DevOps 与基础设施
适合以下场景：编写/审查/重构 Terraform 或 OpenTofu 模块、跨环境（dev/shared/prod）风险评估、状态文件迁移与 moved 区块重构、为 IaC 搭建 GitHub Actions/GitLab CI/Atlantis 流水线、以及需要向审计方证明基础设施变更符合合规框架的团队。受益人群：DevOps/平台工程师、SRE，以及希望在用 AI 生成基础设施代码时获得护栏、避免模型“自信地编造”资源配置的初中级用户。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持。克隆至
~/.claude/skills/terrashark/即可被自动发现，也提供插件市场一键安装（/plugin marketplace add+/plugin install） - Codex：✅ 支持，但非原生技能发现机制——需克隆到项目内并在
AGENTS.md中显式引用工作流路径，官方文档给出了具体步骤 - OpenClaw：❓ 未验证——README 与文档中未提及该平台，未做兼容性判断
- Hermes Agent：❓ 未验证——同上，文档未提及
（另外该项目还额外支持 Antigravity 与 Gemini CLI，不在本站固定评估的四个生态之内，仅供参考）
5. 推荐理由
Terraform 是公认的 LLM 高幻觉重灾区之一——模型很容易编造不存在的资源参数或忽略状态迁移风险。TerraShark 的价值在于把“先诊断、再开药方”的工程纪律固化进技能流程，并强制模型交付可审查的假设/权衡/回滚说明，而不是直接吐出一段“看起来对”的 HCL。对于团队协作或对生产环境改动敏感的场景，这种结构化输出契约能显著降低“模型一本正经生成错误变更”的风险；配合内置的合规映射，也适合需要向审计交付证据的团队。技能本身不含任何可执行脚本、不联网、不需要凭据，属于同类工具中安全性较突出的一款。
6. 评分
| 维度 | 分数 | 依据 |
|---|---|---|
| 受欢迎程度 | 6 | GitHub 301 星 / 21 fork，处于 200–1k 星区间；仓库创建仅约 5 个月即达此量级，增长较快；被至少一篇独立第三方文章（Medium，2026-04-06）列入“Top 15 Terraform Claude Code 技能”第 4 位 |
| 可用性 | 9 | 一条 git clone 命令或插件市场即可安装；README/PHILOSOPHY.md/CONTRIBUTING.md 齐全，19 个分主题参考文件配有取舍说明；最近一次提交发生在取证前 9 天，Git tag 已迭代至 v2.3.0，维护活跃；完全免费，无付费依赖 |
| 安全性 | 9 | 见下方安全检查清单，无一票否决项 |
| 综合 | 8.0 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① 是否执行 shell 命令及权限范围 | SKILL.md 为纯 Markdown 工作流指导，不含内嵌可执行脚本；仅指导 agent 使用其自身已有的 terraform/tofu 命令，且文档明确要求“未经审核计划与批准，不得直接对生产环境执行 apply”，无扣分 |
| ② 运行时是否联网外发数据 | 未发现该技能自身发起任何网络请求，全部为本地参考文件加载，无扣分 |
| ③ 是否要求 API key/凭据 | 不需要任何 API key 或凭据，无扣分 |
| ④ 可疑指令（prompt injection 迹象） | 已通读 SKILL.md 全文及 19 个 references 文件目录，未发现混淆代码或异常指令，无扣分 |
| ⑤ 作者/组织信誉 | 作者 Lukas Niessen 为 2020 年注册的真实 GitHub 账号，40 个公开仓库，现就职于 Bain，非匿名马甲账号，无扣分 |
| ⑥ License 是否明确 | MIT，清晰明确，无扣分 |
| ⑦ 最近维护时间 | 最近提交距取证时仅 9 天，非弃置项目，无扣分 |
7. 跟同类 Skills 相比的优势
| 特性 | TerraShark | Anton Babenko terraform-skill（同类竞品，GitHub 2178 星） |
|---|---|---|
| 核心设计 | 失败模式诊断工作流，先判风险再出方案 | 静态参考手册型 |
| SKILL.md 激活成本 | 约 600 token | 官方文档自述约 4,400 token |
| 参考文件粒度 | 19 个细分文件，按信号条件加载 | 6 个大文件 |
| 输出结构 | 强制包含假设/权衡/回滚说明 | 无固定输出契约 |
| 合规框架映射 | 内置 ISO 27001/SOC 2/FedRAMP/GDPR/PCI DSS/HIPAA | 无 |
| GitHub 星标（本次取证时点） | 301 | 2178 |
| License | MIT | NOASSERTION（未声明标准许可证） |
两者并非互斥：Anton Babenko 的方案胜在成熟度与生态认可度更高；TerraShark 胜在诊断优先的工作流设计、token 效率与合规映射，更适合看重“过程可审查”而非单纯“参考资料齐全”的团队。
8. 用户评价
本次仅收集到 1 条已验证来源的评价，如实说明，不为凑数追加抓取：
- 来源：Medium，作者 Juan Diego Bonilla，《The Top 15 Claude Code Skills Every Terraform Developer Should Be Using》，发布于 2026-04-06
- 内容摘要：文章将 TerraShark 排在 15 个 Terraform 相关 Claude Code 技能中的第 4 位，评价称其“专门为对抗（幻觉）问题而设计——按需加载 18 个细分参考文件，并强制 Claude 在生成代码前先识别失败模式”，认为其输出的假设/权衡/回滚说明比“看起来能跑但未经测试的代码”更可靠，并特别指出其 token 效率优势（约 600 token vs 同类约 4,400 token）。
9. 其他补充
- 仓库内含
PHILOSOPHY.md（设计理念说明）与CONTRIBUTING.md（贡献指南），工程规范较完整 - 提供 GitHub Sponsors 赞助入口，但为可选项，不影响技能本身免费使用
- 未发现多语言文档支持，当前仅有英文版
10. 安装使用方式
方式一：直接克隆（Claude Code，macOS/Linux）
git clone https://github.com/LukasNiessen/terrashark.git ~/.claude/skills/terrasharkWindows PowerShell 用户替换目标路径为 $env:USERPROFILE\.claude\skills\terrashark。克隆完成后 Claude Code 会自动发现该技能，无需重启。
方式二：插件市场（Claude Code）
/plugin marketplace add LukasNiessen/terrashark
/plugin install terrashark方式三：Codex
git clone https://github.com/LukasNiessen/terrashark.git .terrashark随后在项目根目录的 AGENTS.md 中手动添加一段说明，引用 .terrashark/SKILL.md 中的工作流（Codex 无全局技能发现机制，需按项目配置）。
触发方式：可显式调用 /terrashark <需求描述>，也可用自然语言直接提出 Terraform/OpenTofu 相关请求，技能会按内容自动激活。
11. 注意事项
- 官方数据显示的“约 600 token 激活成本”等效率数字，来自项目自述，本次未独立复测，仅供参考
- 该技能定位为“工作流指导”，本身不执行
terraform apply等实际变更操作，最终基础设施变更仍需人工审核确认，使用者不应将其误解为自动化执行工具 - 目前主要由单一作者维护（另有零星社区贡献），需关注后续维护的持续性
- OpenClaw、Hermes Agent 上的可用性未经验证，如在这两个生态使用需自行测试