К основному содержанию
скилл CX Codex

gcp-playbooks — скилл для Claude Code: что делает и как установить

Скилл gcp-playbooks с SRE-плейбуками для расследования инцидентов и восстановления сервисов в GCP и GKE.

Apache-2.0 ★ 151 обновлён 2026-10-12

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add gemini-cli-extensions/sre
/plugin install sre-extension@sre
Открыть на GitHub

Что делает gcp-playbooks

Скилл связывает абстрактные шаги инцидент-менеджмента вроде отката или изоляции с конкретными командами для Google Cloud Platform. Внутри лежат сценарии под отдельные API: обнаружение ресурсов, устранение проблем в Cloud Run (run.googleapis.com) и GKE (container.googleapis.com), а также черновик для Cloud Build.

Работа строится по схеме: сначала агент выясняет границы сбоя через gcp_resource_manager или плейбук обнаружения, затем открывает файл нужного сервиса в references/googleapis.com/ и выполняет команды gcloud либо kubectl с проверкой каждого шага. Без доступа к консольным утилитам GCP и настроенной аутентификации применить эти инструкции на практике агент не сможет.

Какие задачи решает

  • найти затронутые инцидентом ресурсы в GCP через discovery-плейбук
  • выполнить откат или переключение трафика в Cloud Run
  • перезапустить, изолировать или масштабировать поды в GKE
  • провести диагностику сборки в Cloud Build по готовому чек-листу

Примеры запросов агенту

  • Найди ресурсы проекта через discovery playbook и покажи, что упало
  • Сервис в Cloud Run отдаёт ошибки, посмотри gcp-playbooks для run.googleapis.com и предложи план отката
  • Нужно изолировать проблемный под в GKE по playbook для container.googleapis.com

Как установить gcp-playbooks

1Через маркетплейс плагинов

/plugin marketplace add gemini-cli-extensions/sre
/plugin install sre-extension@sre

Команда ставит плагин sre-extension целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add gemini-cli-extensions/sre --skill gcp-playbooks -a claude-code

3Вручную: положить файлы

~/.claude/skills/gcp-playbooks/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/gcp-playbooks/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о gcp-playbooks

Как установить gcp-playbooks в Claude Code?

Выполните в терминале команду npx skills add gemini-cli-extensions/sre --skill gcp-playbooks -a claude-code или добавьте маркетплейс через /plugin marketplace add gemini-cli-extensions/sre и установите плагин /plugin install sre-extension@sre.

Что делает скилл gcp-playbooks?

Предоставляет справочные сценарии расследования инцидентов и сопоставляет действия SRE (откат, изоляцию, рестарт) с вызовами gcloud и kubectl для Cloud Run и GKE.

Какие сервисы Google Cloud поддерживает этот скилл?

В каталоге есть готовые сценарии для Cloud Run (run.md), Google Kubernetes Engine (container.md), черновик для Cloud Build (cloudbuild.md) и руководство по инвентаризации инфраструктуры.

Исходный текст

SKILL.md · Apache-2.0
---
name: gcp-playbooks
description: 🐉 Use when you need to follow established SRE playbooks for GCP/GKE investigations, including infrastructure discovery and common mitigation steps.
metadata:
  author: Riccardo
  version: 0.0.3
  status: draft
---

# GCP SRE Playbooks

## Overview

This skill provides a collection of playbooks and reference materials for SREs to investigate and mitigate incidents on Google Cloud Platform. It focuses on mapping generic SRE concepts (discovery, mitigation, postmortem) to specific GCP/GKE actions.

## Naming Convention

Playbooks follow a deterministic naming convention based on the GCP API service name, located in the `references/googleapis.com/` directory. 
Example: `run.md` (for `run.googleapis.com`).
Each file should also explicitly list the full API name at the top.

## When to Use

- When starting an investigation and needing to discover the infrastructure.
- When following a specific mitigation strategy (e.g., rollback, traffic shifting).
- When a user asks for "GCP playbooks" or "SRE playbooks".

## Available Playbooks

### 1. Infrastructure Discovery

Located at `skills/gcp-playbooks/references/googleapis.com/README.md`. 
Use this to systematically identify the resources involved in an incident.

### 2. Cloud Run Mitigations

Located at `skills/gcp-playbooks/references/googleapis.com/run.md`.
Maps generic mitigations (rollback, fix forward, upsize, restart) to Cloud Run actions.

### 3. GKE Mitigations

Located at `skills/gcp-playbooks/references/googleapis.com/container.md`.
Maps generic mitigations (rollback, fix forward, upsize, quarantine, restart) to GKE / Kubernetes actions.

### 4. Cloud Build Investigation (Draft)

Located at `skills/gcp-playbooks/references/googleapis.com/cloudbuild.md`.

## Core Pattern

1. **Identify the Scope**: Use `gcp_resource_manager` or the discovery playbook to find the relevant project and resources.
2. **Consult the Playbook**: Look for a matching playbook in `references/googleapis.com/` using the short API name.
3. **Execute Actions**: Follow the gcloud/kubectl commands suggested in the playbook.
4. **Validate**: Verify the state of the system after each action.

## References

- [GCP Documentation](https://cloud.google.com/docs)

© Riccardo · Apache-2.0 · gemini-cli-extensions/sre

Похожие скиллы

Все скиллы по теме «Облака: AWS, Azure, GCP» →
gcp-development Mindrally Скилл gcp-development для Claude Code и Codex. Задаёт рамки разработки под Google Cloud: Cloud Functions, Cloud Run, Firestore, BigQuery, Terraform и безопасность через IAM. CX Codex +1 986установок gcp-cloud-run aj-geddes Скилл gcp-cloud-run настраивает запуск контейнеров в Google Cloud Run через gcloud и Terraform. Пригодится при развёртывании микросервисов без возни с серверами. CX Codex +1 545установок wendy-gcp-deployment wendylabsinc Скилл wendy-gcp-deployment задаёт архитектурные стандарты и правила безопасности для подготовки инфраструктуры в Google Cloud с помощью Pulumi и Cloud Run. CX Codex +1 ★ 64звёзд репо terraform-gcp devops-skills Скилл terraform-gcp разворачивает инфраструктуру Google Cloud через Terraform. Настраивает провайдеры, модули VPC, кластеры GKE и базы Cloud SQL. CX Codex +1 431установок gcp-secret-manager devops-skills Скилл gcp-secret-manager для Claude Code помогает хранить секреты в Google Cloud Secret Manager, настраивать IAM и подключать секреты к GKE. Описывает задачи с секретами в GCP. CX Codex +1 382установок cloud-run-alert-configuration официальный google Скилл cloud-run-alert-configuration генерирует политики алертов для сервисов, задач и пулов воркеров Cloud Run в Google Cloud через Terraform и PromQL. Настраивает метрики ошибок, задержек и насыщения контейнеров по SRE-практикам. CX Codex +1 2 300установок

Из того же набора17

Весь набор →
gcp-setup Скилл gcp-setup для Claude Code проверяет и синхронизирует identities в gcloud, ADC и kubectl в начале сессии. Сверяет, чтобы все три системы видели одного пользователя. CX Codex +1 ★ 151звёзд репо data-ingestion Скилл data-ingestion загружает временные ряды из CSV-файлов или внешних источников и преобразует их в единый JSON для анализа. CX Codex +1 ★ 151звёзд репо cloud-logging Скилл для работы с Google Cloud Logging и Error Reporting. Помогает обрабатывать большие JSON-логи из GCP и переводить их в Apache-формат для удобного анализа. CX Codex +1 ★ 151звёзд репо gcp-slo-management Скилл gcp-slo-management находит сервисы в Google Cloud Monitoring и заводит SLO на доступность или задержку через REST API там, где в gcloud нет команды для создания цели. CX Codex +1 ★ 151звёзд репо pre-publish-checker Скилл pre-publish-checker проверяет проект перед публикацией: ищет ругань, внутренние ссылки и пути, а затем помогает пройти ручную проверку качества. Пригодится перед открытым релизом кода или расширения. CX Codex +1 ★ 151звёзд репо safe-sre-investigator Скилл safe-sre-investigator заводит отдельные read-only сервисные аккаунты для GCP и Kubernetes и подсказывает команды gcloud/kubectl вместе с оценкой риска. CX Codex +1 ★ 151звёзд репо cloud-monitoring Скилл запрашивает метрики Google Cloud Monitoring через MCP, сжимает данные в CSV и рисует текстовые спарклайны без перегрузки контекста. CX Codex +1 ★ 151звёзд репо postmortem-aggregator Скилл postmortem-aggregator для Claude Code разбирает Post Mortem в папке, рассчитывает показатели сбоев и обновляет POMO_AGGREGATED.md. Помогает находить повторяющиеся причины инцидентов. CX Codex +1 ★ 151звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой