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

safe-sre-investigator — скилл для Claude Code: read-only GCP и K8s

Скилл safe-sre-investigator заводит отдельные read-only сервисные аккаунты для GCP и Kubernetes и подсказывает команды gcloud/kubectl вместе с оценкой риска.

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

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

Что делает safe-sre-investigator

Скилл готовит доступ, при котором агент смотрит ресурсы GCP и кластера Kubernetes, не держа на руках прав на запись. На выходе две обёртки: safe_gcloud и safe_kubectl. Любую предложенную команду он сопровождает блоком оценки риска.

Для GCP один раз на проект запускается bash ./scripts/setup_safe_sre_investigator.sh PROJECT_ID. Скрипт идемпотентный, кладёт ~/bin/safe_gcloud, после чего оболочку может понадобиться перечитать. Kubernetes настраивается отдельно: bash ./scripts/setup_safe_kubectl.sh CLUSTER_NAME CLUSTER_LOCATION выполняется для каждого кластера, создаёт в нём read-only ServiceAccount и отдельный kubeconfig в ~/.kube/safe-investigator-configs/.

Второму скрипту нужны права на создание ServiceAccount и ClusterRoleBinding в целевом кластере, у обычной read-only учётки он остановится на этом шаге. Для операций записи скилл отдаёт обычную команду gcloud или kubectl и предупреждает, что запускать её надо под своими учётными данными. Роли, которые он выдаёт, лежат в references/iam_roles.md и references/k8s_readonly_role.yaml.

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

  • выдать агенту доступ к GCP-проекту только на чтение
  • посмотреть состояние GKE-кластера, не трогая прод
  • вывести поды в namespace через отдельный kubeconfig
  • получить оценку риска до запуска команды
  • развести доступ по нескольким кластерам по отдельности

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

  • Настрой safe_gcloud для проекта my-project
  • Покажи поды в default командой safe_kubectl my-cluster
  • Дай команду gcloud для списка кластеров GKE и оценку риска к ней

Как установить safe-sre-investigator

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 safe-sre-investigator -a claude-code

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

~/.claude/skills/safe-sre-investigator/SKILL.md

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

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

Вопросы о safe-sre-investigator

Как установить safe-sre-investigator в Claude Code?

Подключите маркетплейс: /plugin marketplace add gemini-cli-extensions/sre, затем поставьте плагин: /plugin install sre-extension@sre.

Что делает safe-sre-investigator?

Создаёт read-only сервисные аккаунты для GCP и Kubernetes, оборачивает вызовы в safe_gcloud и safe_kubectl и добавляет к предлагаемым командам оценку риска.

Kubernetes нужно настраивать заново для каждого кластера?

Да. bash ./scripts/setup_safe_kubectl.sh CLUSTER_NAME CLUSTER_LOCATION запускается отдельно по каждому кластеру: ServiceAccount и kubeconfig создаются именно в нём.

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

SKILL.md · Apache-2.0
---
name: safe-sre-investigator
description: 🐉 Sets up and uses read-only Service Accounts for GCP and Kubernetes investigations using the principle of least privilege, and provides risk assessments for suggested commands. Use when asked to investigate GCP/GKE resources or suggest gcloud/kubectl commands.
metadata:
    author: Riccardo Carlesso
    version: 1.0.8 
    status: draft
# See CHANGELOG.md for version history
---

# Safe SRE Investigator

This skill helps set up and use dedicated read-only Service Accounts for investigating GCP and Kubernetes resources.
It provides wrapper scripts `safe_gcloud` and `safe_kubectl` to ensure commands are run with these limited-privilege accounts.
When suggesting commands, it includes a risk assessment.


## Core Tasks

1.  **Setup GCP:** Initialize the GCP service account and `safe_gcloud` script.
2.  **Setup Kubernetes:** Initialize the Kubernetes service account and `safe_kubectl` script for a specific cluster.
3.  **Suggest Commands:** Provide `gcloud` or `kubectl` commands with risk assessments.

## 1. Setup GCP (`safe_gcloud`)

When first using this skill for a project, or if the user asks for setup, guide them through the one-time setup process for GCP access.

**Action:** Ask the user for the Project ID.

**Script:** Run the setup script:
```bash
bash ./scripts/setup_safe_sre_investigator.sh PROJECT_ID
```
*   This script is idempotent.
*   It creates `~/bin/safe_gcloud`.
*   The user might need to re-source their shell profile.
*   IAM roles are in `references/iam_roles.md`.

## 2. Setup Kubernetes (`safe_kubectl`)

This setup must be run for EACH Kubernetes cluster you want to investigate.

**Action:** Ask the user for the Cluster Name and Cluster Location (Zone or Region).

**Script:** Run the setup script:
```bash
bash ./scripts/setup_safe_kubectl.sh CLUSTER_NAME CLUSTER_LOCATION
```
*   This script needs to be run with user credentials that have permissions to create ServiceAccounts and ClusterRoleBindings in the target cluster.
*   It creates a read-only ServiceAccount in the cluster and generates a dedicated kubeconfig in `~/.kube/safe-investigator-configs/`.
*   It also creates `~/bin/safe_kubectl`.
*   The K8s roles are in `references/k8s_readonly_role.yaml`.

## 3. Suggesting Commands

When the user asks for a command:

*   **GCP:** Use `safe_gcloud PROJECT_ID <gcloud commands>`.
*   **Kubernetes:** Use `safe_kubectl CLUSTER_NAME -- <kubectl commands>`.
*   **Risk Assessment:** ALWAYS include a risk assessment block. See `references/risk_assessment.md`.
*   **Write Operations:** For commands requiring write access, provide the standard `gcloud` or `kubectl` command and warn the user to run it with their own credentials, noting the risks.

**Example `safe_gcloud`:**

```bash
# 🎬 Check GKE cluster status
# ⚠️ Risk: ⚪ NONE: This is a read-only operation.
safe_gcloud my-project container clusters list
```

**Example `safe_kubectl`:**

```bash
# 🎬 List pods in the default namespace
# ⚠️ Risk: ⚪ NONE: This is a read-only operation.
safe_kubectl my-cluster -- get pods -n default
```

## Bundled Resources

*   `scripts/setup_safe_sre_investigator.sh`: GCP setup.
*   `scripts/safe_gcloud_wrapper.sh`: Template for `~/bin/safe_gcloud`.
*   `scripts/setup_safe_kubectl.sh`: Kubernetes setup.
*   `scripts/safe_kubectl_wrapper.sh`: Template for `~/bin/safe_kubectl`.
*   `references/iam_roles.md`: GCP IAM roles.
*   `references/k8s_readonly_role.yaml`: Kubernetes ClusterRole definition.
*   `references/risk_assessment.md`: Risk assessment format.

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

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

Все скиллы по теме «DevOps и инфраструктура» →
Platform SRE for Kubernetes официальный github Субагент Platform SRE for Kubernetes помогает готовить надёжные манифесты Kubernetes, настраивать безопасный rollout и rollback, пробы и политики безопасности без ручного написания бойлерплейта. CX Codex +1 ★ 41 430звёзд репо gke-platform-security официальный google Скилл gke-platform-security для Claude Code помогает настраивать безопасность кластера Google Kubernetes Engine. Он включается при работе с защитой control plane, RBAC, узлами и кластерными дополнениями. CX Codex +1 5 000установок sre-engineer https://github.com/Jeffallan Скилл sre-engineer помогает рассчитать бюджет ошибок, задать SLO, настроить алерты по четырём золотым сигналам и убрать рутину. Пригодится при настройке надёжности сервисов. CX Codex +1 5 700установок cloud-exploitation mrhlaingbwardev Скилл cloud-exploitation для Claude Code разбирает атаки на облачную инфраструктуру и Kubernetes. Включается при запросах про AWS, Azure, GCP, IAM и серверлесс. CX Codex +1 ★ 326звёзд репо gke-workload-identity официальный google Скилл gke-workload-identity диагностирует ошибки аутентификации Pod в Google Cloud через Workload Identity Federation for GKE. Подходит для проверки KSA, IAM и GKE metadata server. CX Codex +1 2 000установок cloud-iam-deep Sachin Sharma Скилл cloud-iam-deep разбирает найденный облачный креденшл: что он разрешает в AWS, Azure или GCP и каким путём из него добраться до админских прав. CX Codex +1 ★ 16 193звёзд репо

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

Весь набор →
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звёзд репо gcp-playbooks Скилл gcp-playbooks с SRE-плейбуками для расследования инцидентов и восстановления сервисов в GCP и GKE. CX Codex +1 ★ 151звёзд репо pre-publish-checker Скилл pre-publish-checker проверяет проект перед публикацией: ищет ругань, внутренние ссылки и пути, а затем помогает пройти ручную проверку качества. Пригодится перед открытым релизом кода или расширения. 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звёзд репо gcp-mcp-setup Скилл gcp-mcp-setup для Claude Code, Codex и Gemini CLI автоматизирует подключение Google Managed MCP-серверов (OneMCP) к CLI-окружению. Включает нужные API, генерирует ключи и записывает конфигурацию в нужный файл настроек. CX Codex +1 ★ 151звёзд репо generic-mitigations Скилл generic-mitigations учит ИИ-агента купировать сбои в продакшене типовыми мерами SRE вместо долгих раскопок причин во время аварии. CX Codex +1 ★ 151звёзд репо

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

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