# runbook-creation

Помогает писать операционные runbook'и, регламенты и инструкции по восстановлению, по которым дежурный инженер сможет действовать без раздумий.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 346 установок · ★ 1177
- Автор: devops-skills
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/BagelHole/DevOps-Security-Agent-Skills/tree/HEAD/compliance/continuity/runbook-creation/SKILL.md
- Обновлён: 2026-05-22
- HTML: https://affpapa.org/nevibecode/skills/runbook-creation

## Что делает

Скилл задаёт структуру документа: владелец, дата проверки, версия, уровень критичности, обзор, предварительные требования, пошаговая процедура с командами и ожидаемым выводом, проверка результата, откат, таблица «симптом — причина — решение», эскалация, связанные runbook'и и журнал изменений.

Внутри есть готовый шаблон и разобранный пример: переключение PostgreSQL на синхронную реплику — от проверки здоровья реплики и остановки записи в приложении до `pg_promote()`, обновления записи в Route53 и возврата подов. Отдельно лежат bash-скрипты: проверка health-эндпоинтов через `curl`, сбор логов инцидента из Kubernetes, CloudWatch и `pg_stat_activity`, контроль сроков действия TLS-сертификатов.

Пример с базой стоит читать как образец, а не как готовый сценарий для вашего кластера: идентификаторы зон, имена деплойментов и хосты там свои, и перед прогоном их придётся заменить. Часть со скриптами в исходнике обрывается на списке доменов, поэтому проверку сертификатов придётся дописывать самому.

## Требования
- Работает с: PostgreSQL, Kubernetes

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add BagelHole/DevOps-Security-Agent-Skills --skill runbook-creation -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/runbook-creation/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/runbook-creation/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add BagelHole/DevOps-Security-Agent-Skills --skill runbook-creation -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/runbook-creation/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add BagelHole/DevOps-Security-Agent-Skills --skill runbook-creation -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/runbook-creation/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install BagelHole/DevOps-Security-Agent-Skills runbook-creation
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/runbook-creation/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add BagelHole/DevOps-Security-Agent-Skills --skill runbook-creation -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/BagelHole/DevOps-Security-Agent-Skills --path compliance/continuity/runbook-creation
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/runbook-creation/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add BagelHole/DevOps-Security-Agent-Skills --skill runbook-creation -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/BagelHole/DevOps-Security-Agent-Skills/tree/HEAD/compliance/continuity/runbook-creation/SKILL.md

## Когда брать
- собрать runbook по единому шаблону, а не с нуля
- описать откат, если процедура пошла не так
- свести симптомы сбоев и причины в одну таблицу
- зафиксировать шаги эскалации с контактами
- подготовить скрипты для сбора логов во время инцидента

## Примеры запросов агенту
- Составь runbook для переключения PostgreSQL на реплику по шаблону из скилла
- Напиши SOP для планового обслуживания кластера: prerequisites, процедура, verification, rollback
- Сделай таблицу troubleshooting для нашего API и добавь шаги эскалации

## Похожие
- [incident-runbook-templates](https://affpapa.org/nevibecode/skills/incident-runbook-templates.md) — скилл · 10900 установок
- [runbook-generator](https://affpapa.org/nevibecode/skills/runbook-generator.md) — скилл · 600 установок
- [backup-disaster-recovery](https://affpapa.org/nevibecode/skills/backup-disaster-recovery.md) — скилл · 620 установок
- [database-admin](https://affpapa.org/nevibecode/agents/database-admin.md) — субагент · 2185 установок
- [sre-engineer](https://affpapa.org/nevibecode/skills/sre-engineer.md) — скилл · 5100 установок
- [devops](https://affpapa.org/nevibecode/skills/mindrally-devops.md) — скилл · 739 установок

Из того же набора: [bagelhole/devops-security-agent-skills](https://affpapa.org/nevibecode/by/bagelhole/devops-security-agent-skills.md) — 127 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md