provider-actions-hashicorp-agent-skills

一、基本信息

二、功能介绍与亮点

本技能教 Agent 用 Terraform Plugin Framework 实现 Provider Actions——一种在资源生命周期事件（创建前/后、更新前/后）触发的命令式操作，用于外部服务调用、凭据轮换、预检、软删除清理等场景。

核心亮点：① 覆盖首次接入 Actions 时的一次性脚手架步骤（实现 ProviderWithActions、在 Configure 中设置 ActionData 等）；② 专列“常见 Schema 陷阱”清单（类型混用、List/Map 缺 ElementType、Computed/Optional 搭配错误等），各配正误代码对照；③ 完整覆盖 Invoke 方法实现、进度上报、超时与轮询、错误处理到文档规范、变更日志格式的全流程，并附提交前检查清单；④ 独立第三方评测平台 Tessl 对本技能单独评测：质量得分 83%、任务表现提升 3.19x（3 个评测场景均值）、综合评级 85，且 Snyk 安全扫描结果为“无已知问题”。

三、适用场景

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

适用于正在开发或维护 Terraform Provider、需要新增或调试 Actions（命令式生命周期操作）能力的 Go 工程师；也适用于已熟悉 Terraform Plugin Framework 资源/数据源开发、现在要扩展到 Actions 这一较新特性的团队。注意：本技能面向“开发 Provider 本身”的场景，而非普通 Terraform 使用者编写基础设施配置。

四、跨 Agent 兼容性

五、推荐理由

HashiCorp 官方把 Terraform Provider Actions 这一较新特性的实现套路，从零散的框架文档变成可核对的代码级指南与陷阱清单，并经独立第三方评测验证效果。

六、评分

安全检查清单：

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

七、跟同类 Skills 相比的优势

核心差异化：市面上通用 Terraform 技能普遍面向“使用 Terraform 的人”，本技能是少数专门面向“开发 Terraform Provider 本身”的细分能力，且单独聚焦 Actions 这一较新特性。

八、用户评价

该技能目前在第三方社区平台尚无具名用户评价；仓库内一条相关反馈来自 HashiCorp 内部员工（非独立第三方用户），未计入本节。独立第三方评测机构 Tessl 对本技能的量化评测已在第六章引用。

九、其他补充

本技能与同目录下的 new-terraform-provider、run-acceptance-tests、provider-resources、provider-test-patterns 共同打包为 Claude Code 插件 terraform-provider-development@hashicorp，覆盖 Provider 开发从脚手架、资源实现、Actions、测试到验收的完整链路；HashiCorp 2026-02 官方公告将 Provider Development 列为该 Agent Skills 库的首批场景之一。

十、安装使用方式

方式一：npx skills 通用安装

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

方式二：Claude Code 插件市场

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

安装后无需重启，Agent 在开发或调试 Terraform Provider 的 Actions 能力时会自动加载本技能。

十一、注意事项

• Actions 是 Terraform 较新的实验性特性（正文明确标注 Terraform 1.14.0 起支持 before_create/after_create/before_update/after_update，before_destroy/after_destroy 尚不支持），后续版本行为可能调整
• 面向已有 Go 与 Terraform Plugin Framework 基础的 Provider 开发者，非面向普通 Terraform 使用者
• 目前仅验证了与 Claude Code 的兼容性，其余 Agent 生态尚未获得直接证据