terraform-patterns
作者 alirezarezvaniterraform-patterns 是一個用於 Cloud Architecture 工作的 Terraform IaC review skill，涵蓋 module design、remote state、provider setup、安全強化、policy-as-code，以及 CI/CD plan/apply 工作流程，並提供輔助腳本協助進行 module 與安全檢查。
此 skill 評分為 82/100；對於希望讓 agent 協助審查、整理或強化 Terraform 程式碼、並減少泛用 prompt 猜測成本的目錄使用者來說，是相當穩健的上架候選。它具備清楚的啟用線索、充實的 Terraform 工作流程指引、參考資料與輔助腳本，可用於 module 與安全檢查；不過若能補上明確的安裝說明，並更清楚標示掃描器的適用範圍，會更容易被採用。
- 觸發條件明確：frontmatter 與 SKILL.md 列出具體使用情境，例如 Terraform review、module design、state backends、security audits、multi-region deployments 與 IaC best practices。
- 實務內容扎實：SKILL.md 篇幅充足，包含用於 review、module design 與 security auditing 的 slash commands，並提供以工作流程為導向的指引與程式碼範例。
- 支援素材實用：references 涵蓋 module patterns 與 state management，scripts 則提供可操作的 module analysis 與 security scanning 入口，並附有使用範例。
- skill 路徑中沒有安裝指令或 README，因此目錄使用者可能需要依照整個 repository 的慣例自行推斷安裝方式。
- 內附的 Python 掃描器看起來是以 regex／靜態模式為基礎，且包含示範用 Terraform 內容，因此應視為輕量輔助工具，而非權威的 Terraform 驗證或安全工具。
terraform-patterns skill 概覽
terraform-patterns 適合用來做什麼
terraform-patterns 是一個 infrastructure-as-code skill，適合讓 agent 協助審查、設計或重構 Terraform，並採用偏向正式營運環境的慣例。它關注的是 module 結構、remote state、provider 設定、安全強化、policy-as-code，以及 CI/CD 中的 plan/apply 流程，而不是基本的 Terraform 語法教學。
當你希望 AI assistant 像 Terraform reviewer 或雲端架構協作夥伴一樣思考時，就適合使用 terraform-patterns：找出有風險的 HCL、提出更清楚的 module 邊界、改善 variables 與 outputs，並在變更進入 production 前說明 state 或安全性上的取捨。
最適合的使用者與 Cloud Architecture 工作
terraform-patterns skill 對 platform engineers、DevOps 團隊、SRE、cloud architects，以及維護共用基礎設施 modules 的開發者最有幫助。它特別適合以 AWS 為主的 Terraform 工作；同時，state 參考資料也涵蓋 GCP 常見的 GCS-style backend patterns。
在 Cloud Architecture 場景中，最強的使用案例包括：設計可重用 modules、規劃多環境配置、依照 blast radius 分離 state、審查 IAM 與網路暴露面，以及把臨時拼湊的 Terraform 轉換成可維護的平台模式。
這個 skill 有什麼不同
不同於一般「幫我 review Terraform」的 prompt，terraform-patterns 內建明確的 slash-command workflows 與支援材料：references/module-patterns.md、references/state-management.md、scripts/tf_module_analyzer.py、scripts/tf_security_scanner.py。這讓 agent 能依照具體條件審查檔案組織、variable/output 覆蓋度、backend 設計、secrets、開放的 security groups、加密缺口，以及過度寬鬆的 IAM。
這個 skill 帶有明確立場。當你需要一致的基礎設施標準時，這是優點；但也表示你應該一開始就提供組織內允許的例外、provider 限制，以及合規要求。
如何使用 terraform-patterns skill
terraform-patterns 安裝情境
請從你的 agent 環境所使用的 repository path 安裝此 skill。在 Claude Skills-style 的設定中，典型指令是：
npx skills add alirezarezvani/claude-skills --skill terraform-patterns
原始碼位於 alirezarezvani/claude-skills 的 engineering/terraform-patterns/skills/terraform-patterns。安裝後，請先檢視 SKILL.md，再閱讀兩份 references，並決定是否要先在本機使用 helper scripts，再請 agent 做最終 review。
使用 slash commands 操作 terraform-patterns
這個 skill 提供三個實用入口：
/terraform:review：用於結構、可維護性，以及 Terraform anti-patterns。/terraform:module：用於設計或重構可重用 modules。/terraform:security：用於 secrets、IAM、networking、encryption，以及 sensitive variable 檢查。
較弱的 prompt 是：「Review this Terraform。」更好的 prompt 是：「Use /terraform:review on modules/vpc and envs/prod. We use AWS provider ~> 5.0, remote S3 state, separate prod/staging accounts, and require least-privilege IAM. Prioritize findings that could cause drift, state coupling, public exposure, or unsafe module interfaces。」
能提升輸出品質的輸入資訊
請提供資深 reviewer 會要求的同等背景資訊：provider 與版本、cloud account model、environment layout、backend type、module tree、CI/CD flow、安全限制，以及這項任務是 greenfield design 還是 refactor。
針對 module 工作，請包含預期使用者、必要 resources、naming/tagging 規則、variable defaults、output expectations，以及哪些部分必須維持 backward compatible。針對 security 工作，請說明是否允許任何 public ingress、secrets 如何管理、加密需求，以及 Sentinel 或 OPA 等 policy-as-code 工具。
優先閱讀的 repository 檔案
先從 SKILL.md 開始，了解 activation patterns 與 slash commands。接著閱讀 references/module-patterns.md，掌握 flat modules、reusable modules、variables、outputs、locals、validation 與 composition patterns。若要調整 backends、workspaces 或 environment separation，請先閱讀 references/state-management.md。
如果你可以在本機執行檢查，可以試試：
python scripts/tf_module_analyzer.py ./terraformpython scripts/tf_security_scanner.py ./terraform --strict
把 script output 作為輸入交給 agent；這會讓 terraform-patterns 的使用更有依據，也能減少空泛的建議。
terraform-patterns skill 常見問題
terraform-patterns 適合初學者嗎？
可以，前提是初學者已經了解基本 Terraform 檔案，並希望有人引導最佳實務。它不是用來取代 terraform init、plan、apply、providers 或 resource syntax 的學習。比起第一份 Terraform 教學，它更適合作為 reviewer 與 pattern guide。
什麼時候不該使用 terraform-patterns？
不要把它當成 production 變更、provider-specific edge cases 或合規簽核的唯一依據。除非只是做概念比較，否則也不建議用它處理非 Terraform 的 IaC。另外，對於產生出的 backend 或 state migration 建議，不應在沒有人工 migration plan 與備份的情況下直接套用。
和一般 prompt 相比有什麼差異？
一般 prompt 可以解釋 Terraform，但常會漏掉一致的 module 邊界、state blast-radius 風險、variable validation，以及安全審查 checklist。terraform-patterns skill 讓 agent 在更聚焦的 operating model 與支援 references 下工作，因此更容易產出可執行的 review comments 與較安全的 refactor plans。
是否支援 multi-cloud Terraform？
概念上，這個 skill 不限於單一 cloud，但最具體的範例與 scanner rules 主要偏向 AWS。內容包含 GCP backend state patterns，而設計原則也仍可套用到不同 providers。若使用 Azure、Kubernetes 或較小眾的 providers，請提供 provider-specific constraints，並要求 agent 區分一般 Terraform 建議與 provider assumptions。
如何改善 terraform-patterns skill 的使用效果
提供 terraform-patterns 更完整的架構脈絡
最常見的失敗模式，是在沒有說明目標架構的情況下要求 review。請說明這份 code 是支援單一 app、共用平台、多個 accounts、多個 regions、受監管 workloads，還是 ephemeral environments。這會影響 module granularity、state separation、provider aliases、IAM boundaries，以及 CI/CD approval gates 的正確答案。
將第一輪發現轉成實作計畫
取得第一輪輸出後，請要求 skill 依照風險與工作量排序 findings：「Group issues into must-fix before apply, should-fix before merge, and backlog. For each must-fix item, show the exact files likely affected and a safe migration sequence。」這能把大方向的 Terraform 建議轉換成可落地的工程計畫。
把 scripts 當作證據，而不是最終真相
內建的 Python scripts 很適合快速掃描，但它們是以 pattern 為基礎的輔助工具，不是完整的 Terraform parser，也不是 cloud security platform。請把它們的 JSON 或文字輸出交給 agent，再請 terraform-patterns 驗證嚴重性、移除 false positives，並提出能保留 module interfaces 的修正方案。
先提供限制條件，再要求產生 code
若想得到更好的 HCL，請先指定 Terraform version、provider versions、backend、naming rules、tagging schema、allowed regions、secret manager、CI tool，以及 compatibility requirements。如果你需要的是 module，也請提供 example inputs 與 expected outputs。契約越清楚，terraform-patterns 越有可能產出可重用、安全，而且實際上能 merge 的 code。