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

lucas-runbook — скилл для Claude Code: что делает и как установить

Скилл lucas-runbook заставляет агента устранять сбои в Kubernetes строго по утверждённым инструкциям. Пригодится при падениях подов и ошибках перезапуска.

MIT 1 установок ★ 361 обновлён 2026-06-08

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add a2wio/lucas --skill lucas-runbook -a claude-code
Открыть на GitHub

Что делает lucas-runbook

Скилл переводит ассистента в регламентный режим устранения инцидентов. При возникновении проблем вроде CrashLoopBackOff, OOMKilled или ImagePullBackOff агент сначала ищет регламенты по маске файлов в каталоге /runbooks либо запрашивает внешнюю документацию через WebFetch. Импровизировать запрещено.

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

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

  • Разобрать причины падения пода OOMKilled по регламенту
  • Найти инструкцию для устранения CrashLoopBackOff в каталоге /runbooks
  • Предотвратить несанкционированные правки инфраструктуры без одобренных шагов
  • Загрузить внешнюю документацию по инциденту через инструмент WebFetch

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

  • В кластере упал под с ошибкой OOMKilled, найди подходящий регламент и разберись
  • Проверь причины CrashLoopBackOff сервиса по инструкциям из папки /runbooks
  • Под завис в ImagePullBackOff, что делать по регламенту?

Как установить lucas-runbook

1Через Skills CLI (Vercel)

npx skills add a2wio/lucas --skill lucas-runbook -a claude-code

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

~/.claude/skills/lucas-runbook/SKILL.md

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

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

Вопросы о lucas-runbook

Как установить lucas-runbook в Claude Code?

Выполните команду npx skills add a2wio/lucas --skill lucas-runbook -a claude-code. Конфигурация сохранится по пути ~/.claude/skills/lucas-runbook/SKILL.md.

Что делает lucas-runbook?

Он обязывает агента искать готовые Markdown-файлы инструкций в /runbooks перед любыми действиями в Kubernetes. Агент следует только утверждённым шагам.

Что произойдёт, если регламент для сбоя не найден?

Агент не будет пытаться починить проблему самостоятельно. Он опишет свои наблюдения и спросит у пользователя, как действовать дальше.

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

SKILL.md · MIT
---
name: lucas-runbook
description: Lucas runbook-driven troubleshooting for Kubernetes issues. Use when investigating pod errors, crashes, restarts, or any Kubernetes problem. Automatically search runbooks before taking action.
allowed-tools: Read, Glob, Grep, WebFetch
---

# Lucas Runbook-Driven Troubleshooting

You are operating in **runbook-driven mode**. Before taking any remediation action, you MUST search for and follow approved runbooks.

## Runbook Sources

Search these locations for runbooks:

### Local Runbooks
- Path: `/runbooks`
- Search using: `Glob pattern="**/*.md" path="/runbooks"`
- Read matching files to find relevant procedures

### External Documentation (if configured)
- Check environment or config for external URLs
- Use WebFetch to retrieve external runbook content

## Procedure

When you identify a Kubernetes issue:

1. **Identify the error type** (OOMKilled, CrashLoopBackOff, ImagePullBackOff, etc.)

2. **Search for matching runbook**:
   ```
   Glob pattern="**/*oom*.md" path="/runbooks"
   Glob pattern="**/*crash*.md" path="/runbooks"
   Glob pattern="**/*image*.md" path="/runbooks"
   ```

3. **Read the runbook** if found

4. **Follow the runbook EXACTLY**:
   - Use only the approved diagnostic commands
   - Apply only the approved fixes
   - Escalate when the runbook says to escalate

5. **If NO runbook found**:
   - Do NOT attempt fixes
   - Report what you observed
   - Ask: "No runbook found for this issue. How should I proceed?"

## Important Rules

- ALWAYS cite which runbook you're following
- NEVER improvise fixes outside of runbooks
- If a runbook says "escalate", do NOT attempt the fix yourself
- Document what you did and the outcome

## Example

When you see OOMKilled:
1. Search: `Glob pattern="**/*oom*.md" path="/runbooks"`
2. Find: `oom-killed.md`
3. Read: The runbook says to increase memory limits
4. Say: "Following runbook `oom-killed.md`: Increasing memory limit from 256Mi to 512Mi"
5. Execute the approved fix
6. Verify and report outcome

© a2wio · MIT · a2wio/lucas

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

Все скиллы по теме «DevOps и инфраструктура» →
incident-runbook-templates Seth Hobson Скилл incident-runbook-templates помогает писать пошаговые инструкции для инцидентов: от обнаружения и первичной проверки до восстановления, отката и эскалации. CX Codex +1 10 900установок cicd-automation-devops-troubleshooter Seth Hobson Субагент cicd-automation-devops-troubleshooter для разбора инцидентов, анализа логов и устранения сбоев в Kubernetes, CI/CD и облачной инфраструктуре. Помогает найти первопричину аварии в продакшене. CX Codex ★ 42 780звёзд репо runbook-creation devops-skills Скилл runbook-creation помогает писать операционные runbook'и, регламенты и инструкции по восстановлению, по которым дежурный инженер сможет действовать без раздумий. CX Codex +1 388установок aks-troubleshooting Microsoft Скилл aks-troubleshooting для Claude Code расследует сбои AKS в режиме только чтения и связывает симптомы с подтверждённой причиной. Разбирает инциденты Azure Kubernetes Service. CX Codex +1 ★ 3 232звёзд репо gke-basics официальный google Скилл gke-basics для Claude Code управляет развёртыванием кластеров GKE, выбором между Autopilot и Standard, получением доступов и деплоем нагрузок. Запускается при создании кластеров GKE и настройке параметров Kubernetes. CX Codex +1 13 953установок gke-workload-troubleshooting официальный google Скилл gke-workload-troubleshooting для Claude Code ищет причины сбоев GKE-нагрузок по логам и событиям. Разбирает незапускающиеся поды и повторные перезапуски. CX Codex +1 4 600установок

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

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