1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | Cloud Sql Basics Google Skills |
| 项目自述名称 | Cloud SQL Basics（SKILL.md frontmatter 显示名称） |
| 作者/维护者 | Google（google/skills 官方仓库，Google Cloud 团队维护） |
| 来源链接 | https://github.com/google/skills/tree/main/skills/cloud/cloud-sql-basics |
| 许可证 | Apache License 2.0（来自 GitHub API，已获取） |
| GitHub Stars / Forks | 15,240 / 1,192（来自 GitHub API，仓库整体数据；google/skills 是合集仓库，此星数不代表该 skill 单独热度，详见第 6 章说明） |
| 该子技能最近提交 | 2026-07-24（来自 GitHub API 对 skills/cloud/cloud-sql-basics 路径的提交历史，已获取，提交内容为“提升 Cloud SQL 安全相关内容准确度”） |
| 最新版本 | 无独立版本号（skill 随仓库滚动更新，无 tag/release 机制） |
| 安装方式 | npx skills add google/skills，安装时勾选 Cloud SQL Basics |
2. 功能介绍与亮点
Cloud SQL Basics 是 Google 官方发布的 Agent Skill，教会 Claude Code 等编码助手创建、管理 Google Cloud SQL 托管数据库（覆盖 MySQL、PostgreSQL、SQL Server 三种引擎）。正文提供一份可直接照抄执行的 PostgreSQL 快速上手流程（启用 API → 建实例 → 建用户与数据库 → 用 Cloud SQL Auth Proxy 连接），并配有 7 份参考文档：核心概念（Enterprise/Enterprise Plus 版本、高可用架构）、gcloud sql 命令速查、Python/Java/Node.js/Go 客户端库接入、MCP 远程服务器用法、Terraform IaC 配置、IAM 权限与安全（含最小权限原则、setIamPolicy 提权风险专项说明），以及灾备与备份（PITR、只读副本、Enterprise Plus 高级灾备）。
主要亮点：Google 官方出品（google/skills 于 2026 年 4 月 22 日 Google Cloud Next 大会首批发布，Cloud SQL Basics 是首批 13 个技能之一）、完全开源可审计、维护活跃（该子目录 2 天前仍有针对安全内容准确度的更新）、IAM 权限文档专项深挖（区分管理员/连接/只读角色，明确警示哪些角色不应下放给应用运行时）。
3. 适用场景
固定分类：DevOps 与基础设施
适合需要让 Claude Code / Codex 等助手协助搭建关系型数据库基础设施的用户：独立开发者为新项目快速开一个 PostgreSQL/MySQL 实例、初中级工程师需要按最小权限原则配置 IAM 角色而非直接套用 Admin 权限、需要规划备份与灾难恢复策略但不熟悉 Cloud SQL 各版本差异的团队——把“该开哪个 API、密码该怎么存、副本怎么配”这类查文档才能搞定的细节，变成 Agent 可直接复用的既有经验。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——
google/skills采用标准 SKILL.md 格式，第三方发布报道明确将 Claude Code 列为支持的 Agent 宿主之一 - Codex：✅ 据官方发布资料与第三方报道，明确支持 Codex（与 Claude Code、Cursor、Gemini CLI 并列，覆盖 30+ 智能体宿主）；该结论依据公开资料提及，暂无一手实测证据
- OpenClaw：❓ 未验证——公开材料中未出现相关信息
- Hermes Agent：❓ 未验证——同上
5. 推荐理由
Cloud SQL 是 Google Cloud 最主流的托管关系型数据库服务，MySQL/PostgreSQL/SQL Server 三种引擎覆盖了绝大多数传统应用的数据库需求，是比自建数据库运维门槛低得多的选择。这份技能是 Google 官方随 google/skills 首批发布、专门为 Agent 场景设计的一手资料——不是社区二次包装。相比同仓库内其他数据库类子技能，Cloud SQL Basics 的参考文档篇幅最完整（主文档加 7 份参考文档共约 42KB），且是仓库内近期唯一专门针对安全准确度做过内容更新的数据库技能，对目标用户从“建实例”到“配好权限与灾备”全流程的实际帮助更直接。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | 官方/一线机构（Google）出品，2026 Google Cloud Next 大会正式发布首批技能之一；仓库整体 star 数属整个合集、不代表本技能自身热度，故改以 Cloud SQL 产品本身的广泛使用度、第三方独立报道（AI Builder Club 专文点名介绍该技能）作为热度依据 |
| 可用性 | 9 | 一条命令安装；SKILL.md 主文档 + 7 份参考文档结构完整、覆盖 CLI/客户端库/IaC/IAM/灾备全流程；该子目录 2 天前仍有内容更新；除自备 GCP 项目与计费账号外无付费依赖 |
| 安全性 | 9 | 详见下方安全检查清单 |
| 综合评分 | 8.7 | （三项均值，四舍五入） |
安全检查清单：
① 是否执行 shell 命令及权限范围——是，调用 gcloud sql / gcloud services enable 等命令及 psql 连接，均限定在 Cloud SQL 实例创建与连接相关操作，权限边界清晰
② 运行时是否联网外发数据——是，但全部请求指向 Google Cloud 官方 API，无第三方外联
③ 是否要求 API key/凭据及存储方式——依赖用户自有的 GCP 标准认证（gcloud auth），技能本身不存储、不索取凭据明文；IAM 参考文档专门提示避免明文密码、建议改用 Secret Manager
④ SKILL.md 与附带参考文档中有无可疑指令——已完整抓取审阅，未发现 prompt injection 或试图变更 Agent 行为的暗示指令
⑤ 作者/组织信誉——Google 官方仓库，信誉极高
⑥ License 是否明确——Apache License 2.0，明确
⑦ 最近维护时间——该子目录 2 天前有提交，非弃置项目
7. 跟同类 Skills 相比的优势
| Skill | 类型 | 与 Cloud SQL Basics 的差异 |
|---|---|---|
database-skills（planetscale/database-skills） |
官方，PlanetScale 出品 | 聚焦 MySQL/PostgreSQL/Vitess 的 schema 设计与查询调优参考，不涉及云端实例创建、IAM、备份等运维环节 |
neon-postgres（neondatabase/agent-skills） |
官方，Neon 出品 | 聚焦 Postgres 连接池与分支（branching）最佳实践，是 Serverless Postgres 产品特有能力，不覆盖多引擎选型 |
postgres（timescale/pg-aiguide） |
官方，Timescale 出品 | 补齐 Agent 写 Postgres 代码时的知识盲区，偏应用层 SQL 写法而非实例运维 |
mongodb-connection（mongodb/agent-skills） |
官方，MongoDB 出品 | 面向文档数据库的连接池配置与故障排查，与关系型数据库运维场景互补而非替代 |
Supabase（supabase/agent-skills） |
官方，Supabase 出品 | 聚焦 RLS 等安全红线的代码层纠错，是 Postgres 之上的 BaaS 平台特有能力，不面向裸 Cloud SQL 实例管理 |
Cloud SQL Basics 的核心差异化：官方一手权威 + 覆盖单一云厂商的实例全生命周期（创建、连接、IAM、IaC、灾备）而非某个数据库产品的应用层写法或托管平台特有能力，是目标用户“从零起步在 GCP 上跑一个关系型数据库”最直接的路径。
8. 用户评价
- AI Builder Club（技术博客）：文章在
google/skills首批发布技能清单中专门列出 Cloud SQL Basics，描述为“Managed MySQL/PostgreSQL provisioning and maintenance”，并评价该仓库的发布“标志着 Google 正把 Agent Skills 当作一线分发渠道”、“能赢得企业市场的 Agent，会是预装了正确技能的那批”。（来源：aibuilderclub.com）
该技能目前在公开渠道可查到的独立评价仅上述 1 条；GitHub 仓库层面存在与数据库产品相关的 issue 讨论，但内容为通用文档链接修复，不构成针对本技能的具名评价。
9. 其他补充
google/skills 是一个持续扩张的官方合集仓库，Cloud SQL Basics 只是其众多子目录之一；同仓库内另有 AlloyDB Basics、BigQuery 系列等数据库/数据类子技能可按需搭配安装。
10. 安装使用方式
npx skills add google/skills执行后会列出仓库内全部子技能供勾选，选择 Cloud SQL Basics 即可仅安装该项。安装后无需重启终端，下次向 Claude Code 提出 Cloud SQL 相关需求（如“帮我在 GCP 上建一个 PostgreSQL 实例”）时会自动触发。使用前需确保：已启用 Cloud SQL Admin API、本地已 gcloud auth login、目标 GCP 项目已配置计费。
11. 注意事项
- 需要用户自备可用的 GCP 项目与计费账号，技能本身不提供免费额度
- 快速上手示例中的部分命令以命令行参数直接传递密码（
--password=PASSWORD），生产环境应改用 Secret Manager 等方式管理凭据，参考文档中已对此有相应提示 - 该技能随官方仓库滚动更新、无独立版本号，无法像普通开源库一样固定版本使用，升级节奏由 Google 一方掌控
- Codex 的兼容性依据公开资料提及、非一手实测；OpenClaw / Hermes Agent 兼容性暂未获验证，如在这些平台使用建议先行小范围测试