terraform-patterns
作者 alirezarezvaniterraform-patterns 是面向 Cloud Architecture 工作的 Terraform IaC review skill，覆盖 module design、remote state、provider setup、security hardening、policy-as-code，以及 CI/CD plan/apply 工作流，并提供用于 module 与 security 检查的辅助脚本。
该 skill 评分为 82/100。对于希望让 agent 审查、整理或加固 Terraform 代码、同时减少通用提示词不确定性的目录用户来说，它是一个可靠的收录候选。它具备清晰的触发线索、较完整的 Terraform 工作流指导、参考资料和辅助脚本；不过，如果能补充明确的安装说明，并更清楚说明 scanners 的适用边界，会更利于采用。
- 触发条件清晰：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，因此目录用户可能需要根据仓库的通用约定自行推断安装方式。
- 随附的 Python scanners 看起来基于 regex/static-pattern，并包含演示用 Terraform 内容，因此更适合作为轻量辅助工具，而不应视为权威的 Terraform 校验或安全工具。
terraform-patterns skill 概览
terraform-patterns 适合用来做什么
terraform-patterns 是一个面向基础设施即代码（Infrastructure as Code）的 skill，适合需要审查、设计或重构 Terraform 的 agent 使用，并且强调生产环境中的工程约定。它关注的是模块结构、remote state、provider 配置、安全加固、policy-as-code，以及 CI/CD 中的 plan/apply 工作流，而不是基础的 Terraform 语法教学。
当你希望 AI assistant 像 Terraform reviewer 或云架构协作伙伴一样思考时，可以使用 terraform-patterns：它能帮助识别有风险的 HCL，提出更清晰的模块边界，改进 variables 和 outputs，并在变更进入生产环境之前解释 state 或安全层面的取舍。
最适合的用户与 Cloud Architecture 场景
terraform-patterns skill 最适合平台工程师、DevOps 团队、SRE、云架构师，以及维护共享基础设施模块的开发者。它尤其适合以 AWS 为主的 Terraform 工作，同时 state 参考内容也覆盖了 GCP 中类似 GCS backend 的模式。
在 Cloud Architecture 场景中，它最擅长的用法包括：设计可复用模块、规划多环境目录结构、按爆炸半径拆分 state、审查 IAM 和网络暴露面，以及把临时拼出来的 Terraform 改造成可维护的平台化模式。
这个 skill 的不同之处
和泛泛地让模型“review my Terraform”不同，terraform-patterns 提供了明确的 slash-command 工作流和配套材料：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 风格的配置中，典型命令如下：
npx skills add alirezarezvani/claude-skills --skill terraform-patterns
源文件位于 alirezarezvani/claude-skills 中的 engineering/terraform-patterns/skills/terraform-patterns。安装后，先查看 SKILL.md，再阅读两个 references，并在让 agent 做最终 review 之前，判断是否需要先在本地运行辅助脚本。
使用 slash commands 调用 terraform-patterns
该 skill 提供三个实用入口：
/terraform:review：用于结构、可维护性和 Terraform 反模式审查。/terraform:module：用于设计或重构可复用模块。/terraform:security：用于检查 secrets、IAM、网络、加密和 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.”
能提升输出质量的输入信息
请给这个 skill 提供一位资深 reviewer 通常会追问的上下文：provider 及版本、云账号模型、环境布局、backend 类型、module tree、CI/CD 流程、安全约束，以及当前任务是 greenfield design 还是 refactor。
如果是模块相关工作，请提供预期使用方、必需资源、命名和 tagging 规则、variable defaults、output 预期，以及哪些内容必须保持向后兼容。如果是安全相关工作，请说明是否允许任何 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 或环境隔离方式之前，先阅读 references/state-management.md。
如果你可以运行本地检查，可以尝试：
python scripts/tf_module_analyzer.py ./terraformpython scripts/tf_security_scanner.py ./terraform --strict
把脚本输出作为输入交给 agent；这样使用 terraform-patterns 时会更有依据，也能减少泛泛而谈的建议。
terraform-patterns skill FAQ
terraform-patterns 适合初学者吗？
适合，但前提是初学者已经理解基本的 Terraform 文件，并希望获得最佳实践方面的引导。它不能替代对 terraform init、plan、apply、providers 或 resource 语法的学习。相比作为第一份 Terraform 教程，它更适合作为 reviewer 和模式指南。
什么时候不应该使用 terraform-patterns？
不要把它作为生产变更、provider 特定边界场景或合规签核的唯一依据。如果不是 Terraform IaC，也不建议使用它，除非你只是需要概念层面的对比。另外，不要在没有手动迁移计划和备份的情况下，直接应用它生成的 backend 或 state migration 建议。
它和普通 prompt 有什么区别？
普通 prompt 也能解释 Terraform，但经常遗漏一致的模块边界、state 爆炸半径问题、variable validation，以及安全审查清单。terraform-patterns skill 为 agent 提供了更窄、更明确的工作模型和配套参考材料，因此更容易产出可执行的 review 评论和更安全的重构计划。
它支持 multi-cloud Terraform 吗？
从设计理念上说，这个 skill 并不限于某一个云，但最具体的示例和 scanner 规则偏向 AWS。它包含 GCP backend state patterns，相关设计原则也适用于不同 provider。对于 Azure、Kubernetes 或较小众的 providers，请提供 provider-specific constraints，并要求 agent 区分通用 Terraform 建议和基于特定 provider 的假设。
如何改进 terraform-patterns skill 的使用效果
给 terraform-patterns 更完整的架构上下文
最常见的失败模式，是在没有说明目标架构的情况下要求 review。请说明这份代码是服务于单个 app、共享平台、多账号、多区域、受监管工作负载，还是临时环境。不同背景会直接改变 module 粒度、state 拆分、provider aliases、IAM 边界和 CI/CD approval gates 的正确做法。
把第一轮发现转成实施计划
拿到第一轮输出后，可以要求 skill 按风险和工作量给发现排序：“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 建议转化为可执行的工程计划。
把脚本结果当作证据，而不是最终结论
随附的 Python scripts 适合快速扫描，但它们只是基于模式的辅助工具，不是完整的 Terraform parser，也不是云安全平台。把它们的 JSON 或文本输出交给 agent，然后让 terraform-patterns 验证严重程度、去除误报，并提出能保持 module interfaces 不变的修复方案。
先提供约束，再请求生成代码
为了获得质量更高的 HCL，请说明 Terraform version、provider versions、backend、命名规则、tagging schema、allowed regions、secret manager、CI tool 和兼容性要求。如果你需要一个 module，也请提供 example inputs 和 expected outputs。契约越清晰，terraform-patterns 越可能生成可复用、安全且便于合并的代码。