Terraform 模块注册表浏览器

你要解决的问题

在 HashiCorp Registry 上找一个 Terraform 模块，往往不是一个"搜一下、点进去、看一眼"就能结束的事。一个模块是否值得引入，至少要核对三件事：它暴露了哪些 输入变量（variables）、运行后产出哪些 输出值（outputs）、以及声明了哪些 provider 依赖（providers）。当你需要在公开注册表和私有注册表之间反复横跳，或者要横向对比几个候选模块时，手动翻页面、读文档的成本会迅速上升。

这个技能做了什么

它把模块检索和评估收敛成一条可重复的流程：

• 检索模块：从 HashiCorp Registry API 以及私有注册表中搜索模块，不再依赖浏览器逐个翻页；
• 解析模块结构：借助 hcl2json 解析器把模块的 HCL 配置转成 JSON，机器可读，便于程序化处理；
• 提取关键信息：从解析结果中抽出输入变量、输出值和 provider 要求，直接呈现给你做判断。

典型的使用路径是：先用它搜到候选模块，再解析其变量与输出，确认与现有代码的约定是否匹配，最后才决定是否引入。

适用边界与注意点

• 它只负责检索和解析，不会替你评估模块的代码质量、维护活跃度或安全性，这些仍需你自己或额外的审计手段完成。
• 私有注册表的可用性取决于你的环境配置，技能本身无法替代注册表的访问凭证或网络连通性。
• 解析结果依赖 hcl2json 对目标 HCL 语法的覆盖程度，遇到解析器不支持的写法时，提取出的信息可能不完整。
• 模块的文档和上游资料应以 Terraform 官方文档为准，技能输出的变量与输出清单只是分析起点，不是最终契约。