runbook-generator · onewave-ai — скилл для Claude Code: генерация инструкций
Скилл runbook-generator для Claude Code анализирует код, конфигурацию инфраструктуры и скрипты деплоя, затем создаёт операционный runbook.md. Документ описывает выкладку, реагирование на инциденты и восстановление.
MIT 252 установок ★ 440 обновлён 2026-10-20
npx skills add OneWave-AI/claude-skills --skill runbook-generator -a claude-codeЧто делает runbook-generator
Сначала скилл ищет файлы и конфигурации проекта, затем анализирует IaC, контейнеры, CI/CD, настройки приложения, мониторинг и скрипты деплоя. По шаблону он формирует runbook.md с девятью разделами, командами из репозитория и диаграммой архитектуры. Результат — не краткая памятка: требуется документ объёмом от 500 строк с оглавлением.
Внутри есть инструкции по поиску файлов, шаблон структуры и правила оформления. Скилл проверяет, существуют ли упомянутые пути и скрипты; непроверенные детали помечает [VERIFY], а пробелы — [ACTION REQUIRED]: .... Он не должен додумывать устройство инфраструктуры. Это важно: runbook может содержать задачи на уточнение, если нужные сведения нельзя подтвердить по проекту.
Для работы с репозиторием используются Read, Glob, Grep, Bash, Write и Edit. Скилл записывает runbook.md в корень проекта или в указанную пользователем папку; команды в документе должны опираться на кодовую базу и включать ожидаемый результат.
Какие задачи решает
- составить инструкции по деплою из конфигураций и скриптов проекта
- описать действия при инцидентах и откате
- собрать процедуры резервного копирования и восстановления
- найти пробелы в эксплуатационной документации
- проверить, существуют ли пути и скрипты из runbook
Примеры запросов агенту
- Составь
runbook.mdдля этого проекта с процедурами деплоя и отката. - Подготовь инструкции для дежурного инженера по реагированию на инциденты в этом сервисе.
- Проверь конфигурации и создай runbook с командами восстановления.
Как установить runbook-generator
1Через Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill runbook-generator -a claude-code2Вручную: положить файлы
~/.claude/skills/runbook-generator/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/runbook-generator/
1Через Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill runbook-generator -a codex2Вручную: положить файлы
.agents/skills/runbook-generator/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill runbook-generator -a cursor2Вручную: положить файлы
.cursor/skills/runbook-generator/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install OneWave-AI/claude-skills runbook-generator2Вручную: положить файлы
.github/skills/runbook-generator/SKILL.md1Через Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill runbook-generator -a gemini-cli2Командой платформы
gemini skills install https://github.com/OneWave-AI/claude-skills --path runbook-generatorВручную: положить файлы
.devin/skills/runbook-generator/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill runbook-generator -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о runbook-generator
Как установить runbook-generator в Claude Code?
Выполните npx skills add OneWave-AI/claude-skills --skill runbook-generator -a claude-code. Файл скилла находится по пути ~/.claude/skills/runbook-generator/SKILL.md.
Что делает runbook-generator?
Он анализирует файлы проекта и создаёт runbook.md с эксплуатационными процедурами, командами и диаграммой архитектуры. Непроверенные детали и пробелы отмечаются специальными метками.
Какой объём и разделы будут у runbook?
Инструкция требует не менее 500 строк и девять разделов, а также оглавление. Содержание разделов адаптируется к тому, что удалось найти в проекте.
Исходный текст
SKILL.md · MIT
--- name: runbook-generator description: Generates comprehensive operational runbooks for any system or process. Reads codebase, infrastructure config, and deployment scripts to produce structured runbook.md files formatted for on-call engineers. Use when you need operations documentation, incident response guides, deployment procedures, or disaster recovery plans. tools: Read, Glob, Grep, Bash, Write, Edit model: inherit --- # Runbook Generator Generate a comprehensive operational `runbook.md` from a system's codebase, infrastructure config, and deployment scripts -- written for on-call engineers working incidents, deployments, and routine operations at 3am. ## Contents - `references/discovery-patterns.md` -- Glob/Grep patterns and config files to inspect during discovery. - `references/output-template.md` -- The full 9-section runbook.md structure to populate. - `references/writing-style.md` -- Clarity, urgency, completeness, formatting, and accuracy rules plus output requirements. ## Workflow 1. Discover the system. Run the Glob patterns in `references/discovery-patterns.md` (Step 1) to identify the stack and infrastructure. 2. Read key configuration. Open and analyze the config files listed in `references/discovery-patterns.md` (Step 2): IaC, containers, CI/CD, app config, deploy scripts, monitoring, migrations, load balancers, docs. 3. Identify operational behavior. Run the Grep patterns in `references/discovery-patterns.md` (Step 3) to surface health checks, metrics, caching, jobs, migrations, rollback, scaling, backups, TLS, secrets, alerting, and more. 4. Generate the runbook. Produce `runbook.md` following the structure in `references/output-template.md`. Cover all 9 sections; adapt content to what discovery found; never include purely speculative sections. 5. Apply writing standards. Follow every rule in `references/writing-style.md` -- copy-pasteable commands, expected outputs, sequential steps, P1-first ordering, tables for structured data, and the accuracy rules. 6. Verify and flag gaps. Confirm referenced paths and scripts exist. Mark unverifiable details with `[VERIFY]` and missing sections with `[ACTION REQUIRED]: ...` so the runbook doubles as a gap analysis. ## Output Write `runbook.md` to the project root (or a directory the user specifies). It must be 500+ lines, cover all 9 sections, contain real commands derived from the codebase, include at least one architecture diagram, carry a complete table of contents, and never fabricate infrastructure details. See `references/writing-style.md` for the full output checklist.
© OneWave-AI · MIT · OneWave-AI/claude-skills
Похожие скиллы
Все скиллы по теме «DevOps и инфраструктура» →Сначала — runbook-generator от других авторов.