Terraform 模块规划器
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_8ee65e73/terraform-module-planner-en。
技能介绍
它解决什么问题
当 Terraform 代码从几百行增长到几千行,团队通常会拆模块。但 拆分本身会制造新问题:variables.tf 里的命名风格不一致、不同模块各自 pin 自己的 provider 版本、outputs.tf 暴露的契约只存在于文档或记忆里、调用方与被调用方的依赖关系靠人肉 grep 才能理清。更常见的是职责重叠——安全组规则既写在网络模块里又写在业务模块里,收紧安全策略时要在多个位置重复修改,漏掉一处就是线上事故。
这个技能做什么
把模块规划拆成四个关键环节:
- 职责边界梳理:先界定模块负责什么、不负责什么,明确列出「非目标」,避免出现「谁都能改」的公共模块。
- 接口契约定义:整理输入变量与输出属性,统一命名、类型和描述,标注哪些资源会因输出回传对上层产生依赖。
- 依赖与版本策略:规划 provider 版本、函数复用与跨模块引用,识别循环依赖和隐式耦合。
- 变更影响评估:修改接口时,基于调用层级列出受影响范围,而不是改完
main.tf后才在 CI 里撞见失败。
适用边界与注意点
- 它产出的是 规划与设计建议,不是可直接落地的
.tf文件,仍需人工校验后实施。 - 无法替代
terraform validate或terraform plan这类静态检查与预览工具,两者是互补关系。 - 结论依赖你提供的代码上下文;仓库里未体现的约定(如团队命名规范)需要显式告知,否则输出可能与现状有偏差。
使用场景
- 你正在为团队拆分公共网络模块,需先界定它负责的网络资源与明确不做什么
- 要修改一个 Terraform 模块的输出,你需要列出所有调用方并评估影响
- 不同模块的输入变量命名不一致?你想在统一契约前先梳理现有变量
- 计划把通用的 AWS 标签格式化逻辑抽成共享函数,想规划复用层级避免循环依赖
适合人员
- Terraform 开发人员:希望把庞大配置拆成职责清晰的模块,减少改动波及范围
- 平台工程师:需要为内部共享模块定义稳定的接口契约,降低跨团队对接成本
- 基础设施负责人:想规划模块演进与依赖关系,控制架构风险
- 审核 Pull Request 的工程师:需要快速判断模块接口变更的影响范围,以决定回归测试范围