lucas-runbook — скилл для Claude Code: что делает и как установить
Скилл lucas-runbook заставляет агента устранять сбои в Kubernetes строго по утверждённым инструкциям. Пригодится при падениях подов и ошибках перезапуска.
MIT 1 установок ★ 361 обновлён 2026-06-08
npx skills add a2wio/lucas --skill lucas-runbook -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/lucas-runbook/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/lucas-runbook/
1Через Skills CLI (Vercel)
npx skills add a2wio/lucas --skill lucas-runbook -a codex2Вручную: положить файлы
.agents/skills/lucas-runbook/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add a2wio/lucas --skill lucas-runbook -a cursor2Вручную: положить файлы
.cursor/skills/lucas-runbook/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install a2wio/lucas src/agent/.claude/skills/lucas-runbook2Вручную: положить файлы
.github/skills/lucas-runbook/SKILL.md1Через Skills CLI (Vercel)
npx skills add a2wio/lucas --skill lucas-runbook -a gemini-cli2Командой платформы
gemini skills install https://github.com/a2wio/lucas --path src/agent/.claude/skills/lucas-runbookВручную: положить файлы
.devin/skills/lucas-runbook/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add a2wio/lucas --skill lucas-runbook -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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