1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | bigquery-optimization-google-skills |
| 作者/维护者 | Google(官方) |
| 来源链接 | https://github.com/google/skills/tree/main/skills/cloud/bigquery-optimization |
| 许可证 | Apache-2.0 |
| GitHub Stars / Forks | 21,805 / 1,861(所属仓库整体数字,不代表本技能自身热度;GitHub API,2026-11-03 读取) |
| 最新版本 | 技能内标注 1.1.1;仓库主分支最近一次提交 2026-11-02 |
| 安装方式 | 把技能目录复制进 agent 的 skills 目录;另需 Google Cloud SDK 与一个有权限的项目 |
数据来源:上述数字取自 GitHub API;功能与评分依据来自技能正文与官方文档。
2. 功能介绍与亮点
一句话:把 BigQuery 的省钱与提速拆成三条线——容量与版本、存储与分区、SQL 与加速结构,每条都给出可执行的做法。
- 容量与版本:评估 editions、预留与按需的取舍,做 rightsizing。
- 存储资产:分区与聚簇设计、存储生命周期、逻辑存储与物理存储的区别、账单模型选择。
- SQL 与加速:单条查询优化、搜索索引、物化视图、BI Engine 的适用判断。
- 边界清楚:用量报表、执行计划分析、具体作业变慢的排障,明确划给同仓库的其他技能。
- 可审计的调用:通过
gcloud或 API 执行时会带使用归因标记,方便企业侧核对是谁在动资源。
3. 适用场景
所属分类:数据分析与可视化。
- BigQuery 账单上涨,需要找出是存储、分区还是查询导致的数据团队;
- 正在评估 editions 迁移或预留容量的平台管理员;
- 表没分区/聚簇、扫描量巨大的数仓建模者;
- 想让 agent 直接给出分区 DDL 与迁移步骤的工程师。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 技能目录安装,按描述触发 |
| Codex | 需适配 | 技能正文通用,命令与项目配置需按平台调整 |
| OpenClaw | 需适配 | 需要平台支持技能目录并允许执行本地命令 |
| Hermes Agent | 未验证 | 未找到该平台的接入示例 |
5. 推荐理由
BigQuery 的费用结构是「存储 + 计算 + 版本」,三者互相牵制:改了分区可能改变扫描量,换了 editions 又影响预留。这个技能按这三层给判断顺序和具体命令,能把「为什么这个月贵了」拆成可验证的几步,而不是只给一句「用分区表」。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Google 官方出品;所属仓库 21,805 stars 是整个合集热度,不代表本技能自身热度 |
| 可用性 | 8 | 文档完整、命令与判断标准都写清楚了;前置是装好 gcloud 并有项目权限 |
| 安全性 | 9 | 见下方清单;官方开源,命令范围明确,使用归因对用户可见 |
安全性检查清单:
| 项 | 结果 |
|---|---|
| ① 执行 shell 与权限 | 通过 gcloud/API 操作用户自己的项目,作用域限于所给项目 |
| ② 联网外发 | 只与用户配置的 Google Cloud 端点通信;命令带使用归因标记,内容透明 |
| ③ 凭据 | 使用 gcloud 已登录的凭据,不要求把 key 写进对话 |
| ④ 可疑指令 | 未见注入或夹带推广 |
| ⑤ 作者信誉 | Google 官方仓库,Apache-2.0,提交历史完整 |
| ⑥ License | Apache-2.0,全文可查 |
| ⑦ 维护时间 | 2026-11-02 仍在更新 |
扣分点:需要真实的 GCP 项目与权限;归因标记会随命令上报技能名,介意遥测的团队需先确认。
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| bigquery-basics-google-skills | BigQuery 入门与基本操作 | 管「怎么用」;本技能管「怎么更省、更快」 |
| bigquery-ai-ml-google-skills | 在 BigQuery 里做机器学习 | 面向建模;本技能面向成本与查询性能 |
| clickhouse-best-practices-clickhouse-agent-skills | ClickHouse 的建表与查询规范 | 另一个引擎;本技能是 BigQuery 的三层优化流程 |
核心差异:同类多给单点建议,它给的是「容量—存储—查询」三层的判断顺序,并明确指出哪些问题不该由它处理。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价(2026-11-03)。
9. 其他补充
- 属于
google/skills合集(180 个技能),可按需只装这一条。 - 技能内标注版本 1.1.1,随官方仓库更新。
10. 安装使用方式
git clone https://github.com/google/skills
mkdir -p ~/.claude/skills
cp -r skills/skills/cloud/bigquery-optimization ~/.claude/skills/
gcloud auth login && gcloud config set project <你的项目>
装好后说「看看这个月的 BigQuery 账单为什么涨了」「这几张表要不要分区」,它会按容量、存储、查询三层给结论。
11. 注意事项
- 需要 GCP 项目与相应权限,纯本地无法验证。
- 命令会带使用归因标记(技能名),企业合规上需先确认。
- 不负责执行计划分析与具体作业排障,那属于同仓库的其他技能。
- 生产环境执行 DDL 前先在测试项目演练。