huawei-terraform-skill

Huawei Terraform Skill

华为云 Terraform 执行型 skill。它是一个自包含 skill，提供 provider 认证、资源模型、依赖发现、示例、排障规则和后续扩展入口，并允许把 Terraform 当成真正的执行介质，而不只是代码模板。

什么时候使用

当任务符合以下任一条件时启用本 skill：

• 生成华为云 Terraform / OpenTofu 配置
• 评审或修改 huaweicloud_* 资源定义
• 将华为云现网资源整理成可审查的 Terraform
• 为华为云资源编写 Terraform 示例、模块、测试或 CI/CD 配置
• 通过 Terraform plan / apply 在华为云上创建、变更或销毁基础设施

如何与其他 skill 配合

与 huawei_skill 的关系

• huawei_skill 适合做现网查询、账号探测、region/project 校验、候选参数补齐。
• 本 skill 适合把经过确认的依赖和约束沉淀成 Terraform，并继续执行 plan / apply。
• 如果用户要求“先查现网，再生成 Terraform”或“先查现网，再帮我落地”，优先先走 huawei_skill，再进入 Terraform 路线。

核心规则

1. 不要套用 AWS 资源名和默认建议

• 华为云 Terraform 必须使用 huaweicloud_* 资源和 data source。
• 不要输出 aws_*、hashicorp/aws、S3 backend、AWS Secrets Manager 这类默认答案。
• 模块结构、测试和 CI/CD 也要以本 skill 内定义的华为云规则为准，不要默认依赖其他 skill 补全。

2. 默认先发现依赖，再写资源

在华为云上，很多配置是否可用取决于 region、AZ、flavor、image、subnet、security group、磁盘类型等约束。

默认流程：

1. 确认认证方式和 region
2. 确认是复用现网资源，还是创建新资源
3. 通过 data source 或 huawei_skill 探测依赖
4. 再生成 resource 定义

除非用户明确给出完整且可信的 ID/参数，否则不要硬编码 flavor、image、subnet。

3. 同时支持 HW_* 和 HUAWEI_*

• provider 官方环境变量是 HW_ACCESS_KEY、HW_SECRET_KEY、HW_REGION_NAME
• 项目现有 MCP 侧常用 HUAWEI_ACCESS_KEY、HUAWEI_SECRET_KEY、HUAWEI_REGION
• 文档和生成代码时优先说明 HW_*
• 但在分析和联动场景里，需要识别并兼容 HUAWEI_*
• 如果两套变量同时存在但值可能冲突，应提醒用户确认实际生效值

4. 优先使用已验证的 Full support 资源

当前用户列出的服务都已经进入 Full support，并且有经过验证的本地示例。

但真正开始产出代码时，不要平均地看待所有服务，优先顺序仍然是：

• 先从现有 starter examples 出发
• 再用变体指南决定是沿用最小模板还是切到高级变体
• 最后再从 inventory 文档里回查 provider 更宽的能力面

5. 默认支持“生成并执行”，不是只停在写代码

• 如果用户目标是“创建”“部署”“落地”“执行变更”“验证能不能跑通”，默认不要停在生成 .tf。
• 默认继续执行：
  1. 写入或更新 Terraform 文件
  2. terraform fmt
  3. terraform init
  4. terraform plan
  5. 在任务授权明确时执行 terraform apply
• 只有在以下情况才停在代码层：
  • 用户明确说“只生成代码”“不要执行”
  • 当前环境缺少必要凭证或 Terraform 运行条件
  • 任务风险较高且用户未授权真正变更资源

默认输出风格

• 优先输出可审查、可复用、可执行的最小可运行配置
• 优先把“发现型 data source”和“创建型 resource”分开写清楚
• 关键 provider 和变量必须包含 docstring/description 级别说明
• 需要时解释为什么用 data source，而不是只给结果

默认执行模式