ooda-loop — скилл для Claude Code: что делает и как установить
Скилл ooda-loop для Claude Code ведёт расследование инцидентов, задержек и расходов в веб-системах. Агент собирает метрики, строит гипотезу и ждёт подтверждения перед любым изменением.
MIT ★ 136 обновлён 2026-11-05
npx skills add daniellockyer/dstack --skill ooda-loop -a claude-codeЧто делает ooda-loop
Скилл переводит отладку и диагностику веб-систем в пошаговый цикл Observe, Orient, Decide и Act. Перед стартом фиксируется одна измеримая цель, например возврат задержки p95 в рамки 300 мс или снижение расходов на серверы. На фазах наблюдения и анализа агент работает строго в режиме чтения: он не трогает конфиги, не запускает перезапуски и не прогревает кэш.
Для сбора фактов скилл опрашивает логи, трейсы, API облачных провайдеров и MCP-серверы мониторинга. Выдумывать числа запрещено правилами скилла: если живой телеметрии нет, агент останавливается и запрашивает доступы. На этапе Decide формулируется ровно одно обратимое действие, описывается риск и критерий отката. К действию исполнитель переходит только после прямого одобрения пользователя, поэтому случайные поломки в проде исключены.
После каждого шага агент сравнивает метрики до и после вмешательства. Если проверка не сошлась с гипотезой, выполняется немедленный откат к исходному состоянию без цепочки непроверенных правок. Отчёт каждого витка фиксирует факты, узкое горлышко и следующий шаг.
Какие задачи решает
- расследовать производственные сбои и аварии веб-сервисов
- найти причину деградации задержек и очередей по реальным метрикам
- снизить расходы на облачную инфраструктуру без нарушения SLO
- проверить гипотезу оптимизации через минимальное обратимое действие
Примеры запросов агенту
- Запусти ooda-loop: нужно вернуть задержку p95 на /checkout ниже 300 мс.
- Помоги срезать расходы на инфраструктуру на 20% без просадки SLO через ooda-loop.
- Сервис отдаёт пятисотые ошибки под нагрузкой. Начни цикл ooda-loop для локализации сбоя.
Как установить ooda-loop
1Через Skills CLI (Vercel)
npx skills add daniellockyer/dstack --skill ooda-loop -a claude-code2Вручную: положить файлы
~/.claude/skills/ooda-loop/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/ooda-loop/
1Через Skills CLI (Vercel)
npx skills add daniellockyer/dstack --skill ooda-loop -a codex2Вручную: положить файлы
.agents/skills/ooda-loop/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add daniellockyer/dstack --skill ooda-loop -a cursor2Вручную: положить файлы
.cursor/skills/ooda-loop/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install daniellockyer/dstack skills/ooda-loop2Вручную: положить файлы
.github/skills/ooda-loop/SKILL.md1Через Skills CLI (Vercel)
npx skills add daniellockyer/dstack --skill ooda-loop -a gemini-cli2Командой платформы
gemini skills install https://github.com/daniellockyer/dstack --path skills/ooda-loopВручную: положить файлы
.devin/skills/ooda-loop/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об ooda-loop
Как установить ooda-loop в Claude Code?
Выполните в терминале команду npx skills add daniellockyer/dstack --skill ooda-loop -a claude-code. Файл навыка сохранится по пути ~/.claude/skills/ooda-loop/SKILL.md.
Что делает скилл ooda-loop?
Он организует структурированное расследование системных проблем по армейской методике OODA. Агент изучает метрики, находит главное ограничение и предлагает по одному безопасному шагу за цикл.
Что нужно для работы ooda-loop?
Агенту нужен доступ к реальным источникам данных: MCP-серверам мониторинга, CLI провайдеров, API метрик или локальным файлам логов. Без телеметрии навык останавливает работу и просит предоставить доступ.
Исходный текст
SKILL.md · MIT
--- name: ooda-loop description: "OODA loop for website performance, scalability, cost, errors, and outages: Observe, Orient, Decide (pause for approval), Act, verify, repeat. Use for ooda-loop, incidents, latency, throughput, capacity, or cloud spend." --- # OODA loop: website systems Loop **Observe → Orient → Decide → (pause) → Act → Observe** until the objective is met or the user stops. Never skip a phase. **Observe, Orient, and Decide are read-only.** No edits, deploys, restarts, scaling, or config/flag changes until Act, and only after the user approves. Anything that adds load or changes runtime state (load tests, cache warming, toggling debug logging or sampling) counts as an Act. ## Objective Before starting, pin one measurable objective the user owns (e.g. "p95 < 300 ms on /checkout", "cut infra cost 20% without SLO breach", "restore service"). If unclear, ask once. ## 1. Observe Collect real, dated, sourced data covering the objective: latency, errors, saturation, traffic, queue depth, spend, alerts, traces, recent changes. Use MCPs, vendor CLIs/APIs, observability tools, or local logs. Never invent numbers; docs and architecture reasoning alone don't count. **Data gate:** if you can't read live or exported signals, stop and ask for access by name: MCP/API/CLI for cloud systems, logs/tracing for local ones. ## 2. Orient Summarize, separating fact, inference, and unknown: - What is true now vs. the healthy/expected state - What changed (deploy, traffic, config, dependency) - Constraints (SLOs, budget, freeze windows, severity) - Blind spots - The dominant constraint: latency, errors, capacity, or cost ## 3. Decide, then pause Propose **one** action, preferring the smallest reversible experiment that tests the Orient picture: - **Action** - **Hypothesis**: which metric improves, by how much - **Invalidation**: what result means abort - **Risk / rollback** - **Tradeoffs** across perf, scale, cost, and reliability **Stop and wait for explicit approval.** If rejected, re-Orient or re-Decide. Incidents pause too, unless the user already authorized a specific mitigation. ## 4. Act Do only the approved action. Capture before/after on the Decide metrics, judge the outcome (good, mixed, bad) against the hypothesis, and note side effects. If invalidation trips, roll back and return to Observe; don't chain Acts. ## Loop - Objective met: stop; report outcome and residual risk - Otherwise: Observe again with post-Act data, then Orient and Decide (pause) - Blind spot blocked learning: close the measurement gap before any new Act ## Report (each cycle) ```markdown ## OODA cycle N: [objective] - Observe: facts (source, window), gaps - Orient: situation, dominant constraint, blind spots - Decide: action / hypothesis / invalidation / risk / tradeoffs (approved | amended | rejected) - Act: what ran, metric deltas, outcome, side effects / rollback - Next: loop | stop | need decision on … ```
© daniellockyer · MIT · daniellockyer/dstack