# Runbook Authoring

> Создать или исправить инструкцию оператора для конкретной штатной операции или вида отказа, с точками принятия решений, проверкой и эскалацией. Использовать, когда процедуру должен суметь выполнить другой человек позднее.

- Skill: `fbakiyev/runbook-authoring` (Agent Skill)
- Install (CLI): `npx skillmds@latest add fbakiyev/runbook-authoring`
- Raw SKILL.md: https://api.skillmd.com/api/skills/fbakiyev/runbook-authoring/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: fbakiyev (https://skillmd.com/u/fbakiyev)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/fbakiyev/runbook-authoring

---


# Подготовка runbook

## Сделай процедуру выполнимой

- Определи условие запуска, желаемый результат, целевую среду, необходимый доступ и человека или роль, которые могут выполнить процедуру. Давай ссылки на учётные данные, не вставляй их значения.
- Начни с наблюдений, отличающих нужный сбой от похожих симптомов. Runbook на все возможные аварии обычно скрывает решение, которое требуется оператору.
- Используй реальные команды проекта и поддерживаемые версии инструментов. Явно отмечай неопределённые параметры: правдоподобная команда с предполагаемым namespace или аккаунтом не является проверенной инструкцией.

## Опиши точки принятия решений

1. Отделяй диагностику только на чтение от действий, меняющих состояние. Для каждого изменения указывай предварительные условия, точный выбор цели, ожидаемый эффект и условие остановки или отката.
2. Покажи, как интерпретировать значимые результаты и выбирать следующий шаг. Список команд без ожидаемых результатов не позволяет оператору понять, когда диагноз ошибочен.
3. Укажи правила повторов для неидемпотентных операций, частичного завершения и асинхронных заданий. Изучи предыдущий результат перед повтором действия, способного продублировать работу.
4. Предусмотри порядок действий при ограниченном или отсутствующем доступе к зависимостям самой процедуры, таким как идентификация, управление развёртыванием или мониторинг, и укажи пути эскалации.
5. Заверши проверкой восстановления на уровне пользователя или данных и перечислением временных изменений, которые необходимо привести к согласованному состоянию. Один код завершения команды не является критерием готовности.

## Проверь и передай результат

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

Предоставь процедуру, пригодную для выполнения без автора, с ответственными и действительно проверенными ссылками. Необязательный `templates/runbook.md` может задать структуру. Не придумывай дашборды, доступ, согласования или успешную учебную проверку. Разрушительные шаги должны оставаться в рамках политики проекта.