mcpField
F
fabric-builder

fabric-builder

github.com/googlecloudplatform云与 DevOps2.1k147 次安装今天更新
代码仓库

关于 fabric-builder

fabric-builder 是为 GCP 基础设施生成 Terraform 根模块的技能，使用 Cloud Foundation Fabric 模块并遵循既定约定。它会先查阅模块资料，避免臆造输入和输出。

主要功能

  1. 01识别所需 GCP 资源及关系
  2. 02检索 Cloud Foundation Fabric 模块资料
  3. 03依据模块信息生成 Terraform 根模块
  4. 04遵循约定配置模块来源与版本
  5. 05提供格式化与验证建议

适用场景

  1. 01根据 GCP 资源需求编写 Terraform 配置
  2. 02查找 Fabric 模块的变量和输出
  3. 03检查生成配置的格式与有效性

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/googlecloudplatform/cloud-foundation-fabric --skill fabric-builder

安装后在 Claude Code 中输入/fabric-builder确认已加载。

附带文件references/conventions.mdscripts/fabric.py

详细介绍

Fabric Builder

此技能使用 Cloud Foundation Fabric（CFF）模块生成符合惯例的 Terraform 代码，并遵循既定的最佳实践和约定。

核心工作流

  1. 理解请求： 识别用户请求的 GCP 资源及其关系。
  2. 获取模块信息： 从 GitHub 上的 modules/ 文件夹中（GoogleCloudPlatform/cloud-foundation-fabric）识别相关的 CFF 模块。
  3. 生成 Terraform： 根据 conventions.md 输出符合惯例、使用 CFF 模块的 Terraform 根模块。

重要指南

  • 约定与最佳实践： 请参阅 conventions.md，了解如何使用 Fabric 模块以及如何编写高质量、符合惯例的 Terraform 代码（包括模块源、版本约束和 provider 配置）。
  • 获取模块： 不要臆造模块输入或输出。使用 fabric.py 脚本从 GitHub 获取特定模块的准确信息（README、变量、示例），然后再使用该模块。
    • 列出可用模块：python3 scripts/fabric.py modules
    • 获取模块详情（README）：python3 scripts/fabric.py fetch readme <module_name>
    • 获取变量文件：python3 scripts/fabric.py fetch variables <module_name>
    • 获取输出文件：python3 scripts/fabric.py fetch outputs <module_name>
    • 获取架构文件（对工厂模块很有用）：python3 scripts/fabric.py fetch schemas <module_name>
    • 获取最新发布版本：python3 scripts/fabric.py release
    • SSL 证书验证： 如果主机遇到 SSL 证书问题，请使用 --no-ssl-verify 标志（例如：python3 scripts/fabric.py --no-ssl-verify fetch readme <module_name>）。

输出指南

  • 根模块输出： 输出必须是完整的 Terraform 根模块，并调用适当的 CFF 模块来满足用户需求。
  • 遵循约定： 严格遵循 conventions.md 中有关模块源、版本约束、provider 配置和代码风格的规定。
  • 使用 Fabric 模块： 尽可能使用 CFF 模块，而非原始的 google_ 资源。
  • 基于示例学习： 始终参阅通过 scripts/fabric.py 获取的模块 README，确认正确的用法示例。
  • 格式化与验证： 确保生成的代码格式正确。如果可能，请运行 terraform fmt、terraform validate 和 terraform plan 来检查代码。

评论

支持 Markdown