技能介绍

它解决什么问题

当你需要给 Terraform 编写自定义 Provider，或者在 HCL 模板生成器里预置资源配置时，常会陷入反复试错的循环：terraform plan 报错后才知道某个字段是 Computed，改完又发现嵌套资源的依赖引用写错了层级。即使熟悉官方文档，也难以快速厘清 Provider 内部各类资源的实际 Schema 结构。

Terraform 提供者模式探索器的目标就是绕过人工阅读文档的环节，直接对 Provider 的结构化描述进行解析。

核心能力

这个技能基于 terraform providers schema -json 命令的输出工作，核心流程如下：

解析 Provider Schema：读取该命令生成的 JSON 描述，完整获取 Provider 中定义的全部 Resource 与 Data Source。
映射资源属性：逐一提取每个资源暴露的字段路径，同时标记哪些字段是 Required，哪些是 Optional。
识别计算字段：将 Computed: true 的字段单独标注，这类字段由 Provider 在运行时填充，不应该出现在用户手写的配置里。
解析跨资源依赖引用：解析字段类型中的引用关系，明确资源属性之间的依赖链条。

适用边界与注意点

技能完全依赖 terraform providers schema -json 的输出，运行前需要确保本地 Terraform CLI 已安装，且能成功执行 terraform init 拉取目标 Provider。
对于自定义编写或未发布的 Provider，同样适用，只需在当前工作目录下完成初始化即可。
解析结果反映的是当前 Provider 版本的 Schema 结构。当 Provider 版本升级后，字段增删或属性变更会导致旧模板报错，需要重新运行探索流程更新映射。