技能包

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」外各工作流程的具體操作清單;審查與修改流程對檔案和網路的完整存取範圍也未逐一列出。使用前建議先在你的環境中驗證。