provider-resources-hashicorp-agent-skills

一、基本信息

二、功能介绍与亮点

本技能教 Agent 用 Terraform Plugin Framework（以及旧版 SDKv2）为 Terraform Provider 实现资源（Resource）与数据源（Data Source）——即 Provider 开发中最核心、最高频的组成部分：通过 Create / Read / Update / Delete 四个操作管理具体的基础设施对象。

核心亮点：① 给出标准的 Go 服务包文件结构（<resource>.go、_test.go、_data_source.go、find.go 等）与配套文档目录结构，帮助 Agent 生成的代码落在团队约定的位置；② 同时覆盖 SDKv2 与 Plugin Framework 两套资源实现范式的完整代码对照，便于处理新旧 Provider 代码库；③ 逐项列出 Schema 设计对照表（字符串/数值/布尔/列表/集合/映射/嵌套对象 → 对应 Framework 类型）、Plan Modifier 与 Validator 用法，以及敏感属性（如密码）标注方式；④ 附资源“未找到”处理、异步状态等待、验收测试（含 Disappears 测试、Import 测试）与文档规范的完整代码样例，并以提交前检查清单收尾。

三、适用场景

固定分类：工程效率与代码质量

适用于正在开发或维护 Terraform Provider、需要新增或调试资源与数据源 CRUD 逻辑的 Go 工程师；也适用于刚接触 Terraform Plugin Framework、需要一份可直接对照的实现范式与测试模式参考的团队。注意：本技能面向“开发 Provider 本身”的场景，而非普通 Terraform 使用者编写基础设施配置。

四、跨 Agent 兼容性

五、推荐理由

HashiCorp 官方把 Terraform Provider 资源与数据源开发这一最核心的实现工作，从框架文档整理成一份新旧两套 API 范式并列、附完整测试与提交检查清单的代码级指南，并随社区反馈持续打磨。

六、评分

安全检查清单：

纯指导性内容、无外联，且为官方出品、完全开源可审计，符合 9-10 档标准，定为 9 分。

七、跟同类 Skills 相比的优势

核心差异化：市面上通用 Terraform 技能普遍面向“使用 Terraform 的人”，本技能是少数专门面向“开发 Terraform Provider 本身”的细分能力，且聚焦资源与数据源这一开发量最大的核心部分。

八、用户评价

该技能目前在第三方社区平台尚无具名用户评价；仓库内围绕该技能的多条改进讨论均来自 HashiCorp/IBM 内部团队成员，非独立第三方用户，未计入本节。

九、其他补充

本技能与同目录下的 new-terraform-provider、provider-actions、run-acceptance-tests、provider-test-patterns 共同打包为 Claude Code 插件 terraform-provider-development@hashicorp，覆盖 Provider 开发从脚手架、资源实现、Actions、测试到验收的完整链路。

十、安装使用方式

方式一：npx skills 通用安装

npx skills add hashicorp/agent-skills/terraform/provider-development/skills/provider-resources

方式二：Claude Code 插件市场

claude plugin marketplace add hashicorp/agent-skills
claude plugin install terraform-provider-development@hashicorp

安装后无需重启，Agent 在开发或调试 Terraform Provider 的资源/数据源实现时会自动加载本技能。

十一、注意事项

• 面向已有 Go 与 Terraform Plugin Framework（或 SDKv2）基础的 Provider 开发者，非面向普通 Terraform 使用者
• 目前仅验证了与 Claude Code 的兼容性，其余 Agent 生态尚未获得直接证据
• 技能覆盖新旧两套 API（SDKv2 与 Plugin Framework），使用时需先确认自己的 Provider 代码库采用的是哪一套，避免混用模式