技能包

modulestf:按 terraform-aws-modules 规则审查和修改 Terraform 模块的 agent skills

想在编码 agent 中按 terraform-aws-modules 规则审查并修改可复用 Terraform 模块的工程师,最适合先用这套 skills 对 PR 做一次带确认点的审查;使用前必须给 agent 配置名为 terraform 的 HashiCorp Terraform MCP server,否则依赖 provider 事实的规则不会运行,审查结论最多是不确定的。

官方来源 · modulestf

安装

git clone https://github.com/modulestf/modulestf.git && ln -sfn "$PWD"/modulestf/.agents/skills/* ~/.claude/skills/

适合谁

  • 这套 agent skills 适合在 Claude Code 或 Codex 中编写和维护 Terraform 模块、并希望按 terraform-aws-modules 系列的成文规则审查或修改模块的工程师。它在你自己的机器上、用你自己的 GitHub 登录运行。
  • 目前只随附一个规则档案:terraform-aws-modules。如果你的项目需要其他家族的规则,官方证据没有说明其适用性。
  • 第一次使用前必须给 agent 配一个名为 terraform 的 Terraform MCP server。官方明确:没有它,需要 provider 事实的规则会报告为 not run,PR 审查至多是「不确定」结论。
  • 不清楚你的模块是否属于这一家族时,先从下面的低风险审查开始。

3 分钟完成第一次尝试

前置:已安装 Claude Code,并已按官方说明把 HashiCorp Terraform MCP server 以名字 terraform 接入 agent。需要声明副作用:审查工作流会把 PR 克隆到临时目录,并在每个 example 里运行 terraform init -backend=false 和 terraform validate——官方说明这不写 state、不用真实 backend,但会在临时目录执行 Terraform 命令。

  1. 克隆仓库并把全部四个 skill 目录放进 Claude Code 的 skills 目录:
git clone https://github.com/modulestf/modulestf.git
ln -sfn "$PWD"/modulestf/.agents/skills/* ~/.claude/skills/
  1. 在 Claude Code 中发起一个低风险任务:对一个已有的可复用 Terraform 模块的 PR 跑审查(诊断型操作)。成功信号:agent 给出 verdict、findings 和一条建议的 PR 评论草稿。
  2. 关键确认点:在你确认之前什么都不会发布;确认时你同时选定审查事件——发布评论、批准(approve)或要求修改,以官方列出的这三种为准。审查流程除上述命令与网络外是否会读写其他文件或访问网络,官方未逐一说明,保持未知。
  3. 若部分规则提示 not run,先检查 terraform MCP server 是否已正确接入。

使用案例

  1. PR 审查:在 Claude Code 中让 agent 按 terraform-aws-modules 规则审查一个打开的 PR。工作流会把 PR 克隆进临时目录、在每个 example 中运行 terraform init -backend=false 与 terraform validate,然后给出结论、发现项和拟发布的评论;你确认评论与选择审查事件之前,不会发布任何东西。
  2. 审后改动:审查给出结论后,让 agent 按 review 的要求修改模块。官方说明这套 skills 会「review, change and create reusable Terraform modules」,并帮助完成 review 要求的变更;改动会修改模块文件,因此发起前先确认涉及哪些文件。官方证据未列出该改动的逐步操作细节,可确认到的是它会按档案规则执行改动,前提是先有 review 的发现项。

使用边界

  • 明确的副作用限制(官方原文):没有 skill 会运行 terraform apply、写 state 或使用真实 backend;没有 skill 会 merge、push 到 pull request 或解决 threads。审查流程在确认前不发布评论或审查事件。注意:官方只列出了上述限制,并未说明 change 工作流是只读的——这套 skills 的定位包含按 review 要求改动和创建模块,该工作流会修改模块文件,改动前请自行确认范围。
  • 运行前提:Claude Code 或 Codex 本地运行,使用你自己的 GitHub 登录;安装方式是复制或符号链接四个目录,两个平台的 skills 目录分别为 ~/.claude/skills/ 与 ~/.agents/skills/。其余安装方式或平台的证据未说明。
  • 审查需要先克隆 PR 并在临时目录执行 terraform init/validate,本地需有 Terraform 环境。
  • 未确认的关键信息:官方证据未说明支持的 Terraform 版本、provider 范围、是否兼容其他 agent,以及除「review, change and create」外各工作流的具体操作清单;审查与改动流程对文件和网络的完整访问范围也未逐一列出。使用前建议先在你的环境中验证。