gcp-playbooks — скилл для Claude Code: что делает и как установить
Скилл gcp-playbooks с SRE-плейбуками для расследования инцидентов и восстановления сервисов в GCP и GKE.
Apache-2.0 ★ 151 обновлён 2026-10-12
/plugin marketplace add gemini-cli-extensions/sre
/plugin install sre-extension@sreЧто делает 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-code3Вручную: положить файлы
~/.claude/skills/gcp-playbooks/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/gcp-playbooks/
1Через Skills CLI (Vercel)
npx skills add gemini-cli-extensions/sre --skill gcp-playbooks -a codex2Вручную: положить файлы
.agents/skills/gcp-playbooks/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add gemini-cli-extensions/sre --skill gcp-playbooks -a cursor2Вручную: положить файлы
.cursor/skills/gcp-playbooks/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install gemini-cli-extensions/sre skills/gcp-playbooks2Вручную: положить файлы
.github/skills/gcp-playbooks/SKILL.md1Через Skills CLI (Vercel)
npx skills add gemini-cli-extensions/sre --skill gcp-playbooks -a gemini-cli2Командой платформы
gemini skills install https://github.com/gemini-cli-extensions/sre --path skills/gcp-playbooksВручную: положить файлы
.devin/skills/gcp-playbooks/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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