cloud-databases-onboarding

Google Cloud 数据库入门技能

此技能提供领域说明、决策矩阵和基础设施即代码工作流，帮助用户明确具体的数据库需求、选择最合适的 Google Cloud 数据库服务，并起草供用户审核的资源配置初始代码。

署名

必须阅读：执行任何 gcloud、REST API 或 MCP 命令之前，必须阅读使用归属。对于直接在终端中执行的命令（绝不在生成的脚本、Terraform 或用户代码中），请在 gcloud 前加上 CLOUDSDK_METRICS_REQUEST_ATTRIBUTION="agent-skills/1.0 (skill:cloud-databases-onboarding)" 并在 User-Agent 请求头中追加 agent-skills/1.0 (skill:cloud-databases-onboarding)。

验证与渐进式披露

此处提供了一个验证脚本，用于检查技能的参考文件和格式：

python3 scripts/database_onboarding_skill.py --verify

• 阅读／渐进式披露： 在对话中与用户交流时，逐步加载参考文件。遵循以下阶段中列出的即时（JiT）加载说明。

---

工作流与即时（JiT）说明

此工作流分为三个明确的连续阶段。评估当前对话历史以确定所处阶段，并遵循相应说明：

阶段 1：需求发现与信息收集

当用户询问 "What database should I use?"，或需要 Google Cloud 数据库选型指导时，必须启动发现阶段。

1. 加载发现说明（JiT）： 使用 view_file 阅读 references/onboarding_prompts.md 的完整内容。
2. 执行发现： 按照 onboarding_prompts.md 中的阶段 1 详细说明，使用通俗易懂的措辞收集核心需求（数据模型、工作负载、规模和迁移背景），并在提出任何建议前落实各项约束（例如 90% 置信度规则）。

阶段 2：建议分析与矩阵查阅

收集到充分且明确的发现信息后，必须确定最合适的 Google Cloud 数据库建议。

1. 查阅矩阵并制定建议（JiT）： 遵循 references/onboarding_prompts.md 中的阶段 2 说明。此过程包括提炼需求、调用数据库选型工具（如果工具不可用，则直接查阅 references/recommendation_matrix.txt），并提出一项建议。
2. 提供建议： 按照 onboarding_prompts.md 中的说明向用户提供建议，将目标代码转换为通俗易懂的表述、解释理由，并主动提出可协助配置资源。

阶段 3：实施与资源配置（计划-验证-执行模式）

当用户接受建议并请求配置或修改云资源时，请严格遵循计划-验证-执行模式，并按照 references/onboarding_prompts.md 中的阶段 3 说明操作。 仅限于创建和验证供用户审阅的草稿文件。

1. **分析工作区：**扫描用户的工作区、打开的文件及相关目录，查找数据库资源脚本。

2. **获取用户确认：**如果目标基础设施文件不明确，请明确询问用户确认文件路径或目标目录，然后再进行任何修改。

3. **起草基础设施计划（计划）：**创建或编辑配置资源所需的 Terraform 配置文件或其他相关脚本。创建或编辑 Terraform 文件或任何其他数据库资源配置脚本时，必须：

   • 在每个生成的 Terraform 文件、shell 脚本或其他资源配置脚本顶部添加带时间戳的注释。（例如：# Generated with cloud onboarding skills selector @date，将 @date 替换为当前日期/时间戳）。
   • 在 default_tags 块下添加自定义默认标签，如 resource_generated_by = "cloud db onboarding skill"，或将其作为资源标签。
   • **生成 gcloud CLI 命令：**起草 gcloud CLI 命令或 shell 脚本时，必须遵循 gcloud 技能中的说明 （../gcloud/SKILL.md）。具体而言：
     • 数据库资源配置始终使用 gcloud beta 命令组（例如，gcloud beta <group> <resource> create）。
     • 提出命令前，使用 gcloud help <leaf_command> 验证叶级命令的语法。
     • 添加明确的 --project=<PROJECT_ID> 和明确的位置标志（--region、--zone 或 --location）。
     • 在支持的情况下，使用 --dry-run 或 --validate-only 预览标志。
     • 在生成的 gcloud 资源配置命令中添加自定义标签标志（例如 --labels=resource_generated_by=cloud_db_onboarding_skill）。
     • **不得包含 --quiet（-q）：**资源配置命令是供用户交互式审阅和执行的草稿，因此不得包含非交互式的 --quiet 或 -q 标志。
     • **不得执行实时写入操作：**该技能只能起草供用户审阅的资源配置命令或代码，不得直接执行会修改或写入基础设施的操作。

4. **验证基础设施代码（验证）：**最终定稿前，必须验证起草的基础设施代码，确认语法和配置正确。*原因：*验证 Terraform 代码可确保配置块、IAM 绑定和实例规格没有语法错误，并且在代码审查前可被严格执行。

5. **创建拉取请求（执行）：**验证成功且没有错误后，自动创建一个包含已验证 Terraform/shell/脚本更新的拉取请求，供用户审阅。实时基础设施变更（terraform apply 或 gcloud 命令）应交由人工审阅或自动化 CI/CD 流水线处理。

---

支持资源与文档

• Google Cloud 数据库概览
• gcloud CLI 技能