1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | google-cloud-slo-alert-configuration-google-skills |
| 作者/维护者 | Google Cloud(仓库账号 google,提交记录以内部同步账号 Cloud IX Team 为主) |
| 来源链接 | https://github.com/google/skills/tree/main/skills/cloud/google-cloud-slo-alert-configuration |
| 许可证 | Apache-2.0(GitHub API 确认) |
| GitHub Stars / Forks | 18,252 / 1,441(GitHub API 实测;该数字为 google/skills 仓库整体,本技能所在子目录不单独统计 star,仅作背景参考) |
| 最新版本 | 无正式 Release/Tag,滚动更新;本技能所在子目录最近一次实质性提交为 2026-08-06 |
| 安装方式 | npx skills add google/skills,安装时从交互列表勾选本技能 |
2. 功能介绍与亮点
google-cloud-slo-alert-configuration 是一个对话式配置向导:用户只需说出想为哪个 Google Cloud 服务设置 SLO(服务级别目标),本技能负责通过结构化提问收集齐 4 类要素——监控范围(Service Scope)、目标水位(Service Level)、判定指标(SLI)、告警策略——并最终生成一份可直接 terraform apply 的 google_monitoring_alert_policy 配置。
主要亮点:
- 四步向导流程固定、不遗漏:正文明确要求一次性收集完所有缺失信息再统一提问,而不是问一项、等一次、再问下一项,减少多轮往返。
- 内置 SRE 最佳实践默认值:每一步都自带 Google SRE Workbook 式的推荐配置——如 99.9%(三个九)滚动 28 天窗口、可用性用比率型 SLI、延迟用窗口型 SLI、同时配置多窗口快慢突发率告警——用户不给具体数字时也能拿到一份符合业界惯例的合理配置。
- 自动发现目标资源:能力上支持在用户只给出模糊服务名时,自主调用
gcloud apphub/gcloud asset search-all-resources等只读命令列出候选资源,减少用户手动查找资源全名的负担。 - 无专属 MCP 依赖:全流程只依赖标准
gcloud命令行工具与 Terraform 输出,不要求安装或连接任何专属 MCP 服务器,且自带app_hub_labels.md、service_metrics.md、promql_templates.md三份参考文档,安装单元自包含。
3. 适用场景
固定分类:DevOps 与基础设施。适用于需要为 Google Cloud 服务(尤其是通过 App Hub 或 Cloud Run 等注册的服务)配置 SLO 告警、但不熟悉 PromQL 语法与 Terraform 资源写法的 SRE、运维与平台工程人员,尤其适合刚开始为团队服务建立可观测性基线的初中级用户。
4. 跨 Agent 兼容性
- Claude Code:✅ 原生支持——仓库 README 提供
npx skills add google/skills通用安装,以及claude plugin marketplace add google/skills插件市场安装两种路径。 - Codex:✅ 原生支持——README 明确列出
codex plugin marketplace add google/skills安装方式。 - OpenClaw:❓ 未验证——README 未提及该生态。
- Hermes Agent:❓ 未验证——同上。
5. 推荐理由
配置 SLO 告警的门槛往往不在“要不要做”,而在“PromQL 怎么写、Terraform 资源块怎么组织、SRE 最佳实践的具体数字是多少”——新手常常卡在这几个细节上迟迟不敢动手。本技能把这件事拆成结构化对话,边问边给业界惯例参考值,最后直接吐出可套用的 Terraform 配置与人话解释,核心流程只依赖标准 gcloud 工具,不绑定任何专属付费服务或 MCP 服务器。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Google Cloud 官方团队直接维护;仓库整体 18,252 stars、Apache-2.0,该数字覆盖整个 google/skills 合集仓库,不代表本技能子目录自身热度,本技能自身目前未见独立第三方报道或采用数据 |
| 可用性 | 9 | 全流程为标准 gcloud 命令 + Terraform 输出,无需任何专属 MCP 服务器或额外付费服务;正文含完整四步向导逻辑、三份参考文档(标签映射、指标清单、PromQL 模板)与 SRE 最佳实践默认值;子目录最近一次实质提交为 2026-08-06,距今约一周 |
| 安全性 | 9 | 见下方检查清单 |
| 综合 | 8.33 | 三项均值 |
安全检查清单:
- ① Shell 命令执行:全部为
gcloud apphub/gcloud asset search-all-resources/gcloud run services list等只读发现命令,用于定位监控目标;正文未出现任何写操作或破坏性命令。 - ② 联网外发:仅调用 Google Cloud 官方 API 查询用户自己项目内的资源信息,不涉及第三方外发。
- ③ API Key/凭据:不索取任何凭据,依赖用户本地已配置的标准
gcloud认证。 - ④ 可疑指令:通读全文未发现夹带推广、隐蔽外发或 prompt injection 迹象;正文的强制性措辞(如“MUST”“DO NOT”)全部服务于向导流程本身的严谨性,不涉及任务无关内容。
- ⑤ 作者信誉:Google Cloud 官方团队维护,无造假迹象。
- ⑥ License:Apache-2.0,仓库层级明确。
- ⑦ 维护时间:最近一次实质性提交距今约一周,维护活跃。
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本技能的差异 |
|---|---|---|
| gke-reliability-google-skills | 同一合集内的 GKE 可靠性技能,覆盖 PodDisruptionBudget、健康检查、多可用区容灾等更广的可靠性配置面 | 依赖专属 MCP 工具(get_cluster、describe_k8s_resource 等)读取集群状态;本技能不涉及集群内部资源读取,只针对 SLO 告警这一垂直场景生成 Terraform 配置,全程免 MCP |
| cloud-monitoring-metric-selection-google-skills | 同一合集内的监控指标选型技能,帮用户从海量 Cloud Monitoring 指标中挑出合适的观测指标 | 关注“该看哪个指标”这一前置问题,产出是指标选型建议;本技能关注“选定指标后如何落地成可执行的告警策略”,产出是可直接部署的 Terraform 配置 |
| grafana-oss-grafana-skills | 面向自托管 Grafana/Prometheus 技术栈的告警与仪表盘配置技能 | 服务对象是自建 Grafana 生态,配置产出格式为 Grafana 原生告警规则;本技能服务对象是 Google Cloud 原生 Monitoring,产出格式为 Terraform HCL,两者面向不同的可观测性技术栈 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。google/skills 仓库本身于 2026 年 Google Cloud Next 大会正式发布,被 Google Cloud 官方博客及多家科技媒体报道为 Google 官方 Agent Skills 仓库,但相关报道聚焦仓库整体发布,未点评本技能个体。
9. 其他补充
同仓库内多个 gke-* 与 cloud-monitoring-* 技能共同构成 Google Cloud 可观测性技能族,本技能是其中专注“SLO 告警策略生成”这一垂直环节的一员。
10. 安装使用方式
- 通用安装(推荐):终端运行
npx skills add google/skills,从交互列表中勾选 “SLO Alert Configuration Setup Wizard” 完成安装。 - Claude Code 插件方式:
claude plugin marketplace add google/skills,再按需claude plugin install <plugin>@google-plugins。 - Codex:
codex plugin marketplace add google/skills,再从/plugins浏览器内安装。 - 安装后无需重启;在请求涉及“配置 SLO/服务级别目标/告警策略”等场景时会被 agent 自动匹配触发。使用前需本地已安装并认证 Google Cloud SDK(
gcloud),且已知悉目标服务是否已注册到 App Hub(未注册也可用标准资源标签兜底)。
11. 注意事项
- 生成的是 Terraform 配置文件本身,本技能不负责执行
terraform apply,落地部署需用户自行确认后手动执行。 - 若目标资源类型在内置
service_metrics.md参考文档中未收录默认指标,向导会要求用户提供自定义指标名,而非自行拼凑,避免生成不准确的告警条件。 - 通知渠道(notification_channels)默认留空,若未配置,向导会在最终摘要中提醒但不会阻断配置生成,用户需自行接入告警接收渠道。