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

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

Скилл oma-debug для Claude Code и Codex воспроизводит ошибки в кодовой базе, находит первопричину сбоя и готовит точечный патч. Запускается при падении тестов, сбоях в рантайме или плавающих регрессиях.

MIT ★ 1 472 обновлён 2026-11-12

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add first-fluke/oh-my-agent
/plugin install oma-frontend@oh-my-agent
Открыть на GitHub

Что делает oma-debug

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

После исправления скилл ищет похожие дефекты по всему проекту. Итоговые отчёты и разбор причин поломки сохраняются в каталог .agents/results/bugs/. Для работы агенту нужны локальные команды тестов, линтера или сборки проекта, а для расширенной навигации по символам может подключаться инструмент Serena.

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

  • воспроизвести падение теста или необработанное исключение в коде
  • найти первопричину сбоя без расширения границ правок
  • написать регрессионный тест для найденного дефекта
  • сохранить отчёт о сбое и рисках в каталог .agents/results/bugs/

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

  • Разберись, почему падает тест auth_spec.ts с ошибкой токена
  • Локализуй сбой в обработчике очереди и напиши регрессионный тест
  • Исправь гонку состояний в fetchData и задокументируй причину

Как установить oma-debug

1Через маркетплейс плагинов

/plugin marketplace add first-fluke/oh-my-agent
/plugin install oma-frontend@oh-my-agent

Команда ставит плагин oma-frontend целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add first-fluke/oh-my-agent --skill oma-debug -a claude-code

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

~/.claude/skills/oma-debug/SKILL.md

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

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

Вопросы об oma-debug

Как установить oma-debug в Claude Code?

Выполните команду npx skills add first-fluke/oh-my-agent --skill oma-debug -a claude-code в терминале проекта.

Что делает oma-debug?

Скилл находит корень ошибки, вносит минимальное исправление в код, пишет тест от регрессий и сохраняет отчёт в .agents/results/bugs/.

В каких случаях oma-debug не подходит?

Скилл рассчитан строго на устранение дефектов. Для разработки новой функциональности или общего код-ревью в наборе oh-my-agent используются другие специализированные агенты.

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

SKILL.md · MIT
---
name: oma-debug
description: Diagnose a reproducible failure, fix its cause, and verify the
  regression. Use for crashes, incorrect behavior, and failing tests.
---

# Debug Agent - Bug Fixing Specialist

## Scheduling

### Goal
Reproduce, diagnose, minimally fix, and regression-test bugs while preserving scope discipline and documenting root cause.

### Intent signature
- User reports a bug, crash, traceback, exception, error message, performance issue, intermittent failure, or regression.
- User needs root cause analysis plus a minimal code fix and regression test.

### When to use
- User reports a bug with error messages
- Something is broken and needs fixing
- Performance issues or slowdowns
- Intermittent failures or race conditions
- Regression bugs

### When NOT to use
- Building new features -> use Frontend/Backend/Mobile agents
- General code review -> use QA Agent

### Expected inputs
- Error message, failing behavior, reproduction steps, logs, test failure, or affected code path
- Existing tests, stack traces, environment notes, and suspected regression boundary

### Expected outputs
- Root cause explanation
- Minimal fix scoped to the failing behavior
- Regression test or explicit reason it cannot be added
- Bug documentation under `.agents/results/bugs/` when appropriate

### Dependencies
- `resources/execution-protocol.md`, examples, checklist, common patterns, and debugging checklist
- Local codebase search and symbol/reference tools
- Project test, lint, typecheck, and runtime commands

### Control-flow features
- Branches by reproduction success, error class, suspected layer, and verification outcome
- Reads logs/code/tests and writes code/tests/docs
- Must search for similar patterns after fixing

## Structural Flow

### Entry
1. Capture the reported symptom and suspected scope.
2. Reproduce or establish the closest reliable failing signal.
3. Identify affected files, tests, and related patterns.

### Scenes
1. **PREPARE**: Gather symptoms, logs, reproduction path, and verification command.
2. **ACQUIRE**: Read failing code, tests, references, and similar patterns.
3. **REASON**: Isolate root cause and reject unsupported hypotheses.
4. **ACT**: Apply minimal fix and regression test.
5. **VERIFY**: Re-run failing and related checks.
6. **FINALIZE**: Document root cause, fix, test, and residual risk.

### Transitions
- If reproduction fails, use logs/tests to establish a weaker but explicit diagnostic signal.
- If the first fix fails verification, return to root-cause analysis.
- If similar patterns exist, inspect and patch only affected cases.
- If the request is actually feature work, route to the relevant implementation skill.

### Failure and recovery
- If environment is missing, document the blocker and provide the closest static diagnosis.
- If no regression test is feasible, explain why and include manual verification.
- If fix scope grows, stop and call out the broader design issue.

### Exit
- Success: bug is fixed, regression coverage exists, and checks pass.
- Partial success: root cause or verification blocker is explicit.

## Logical Operations

### Actions
| Action | SSL primitive | Evidence |
|--------|---------------|----------|
| Reproduce failure | `CALL_TOOL` | Test/runtime/log command |
| Search affected code | `READ` | Code, tests, symbols, references |
| Compare similar patterns | `COMPARE` | Pattern search |
| Infer root cause | `INFER` | Diagnostic reasoning |
| Write minimal fix | `WRITE` | Code patch |
| Write regression test | `WRITE` | Test patch |
| Verify behavior | `VALIDATE` | Tests/checks |
| Report result | `NOTIFY` | Root-cause summary |

### Tools and instruments
- Project test, lint, typecheck, runtime, and logging commands
- Configured code-intelligence symbol/reference/pattern search with native fallback
- Debugging checklist and bug report template

### Canonical workflow path
Use the configured code-intelligence provider to locate files and inspect symbols
or content. For Serena, use `find_file`, `search_for_pattern`,
`get_symbols_overview`, and `find_symbol`. Native search is limited to the
provider exclusions and non-code paths permitted by the project's search policy.


Then run the smallest reproduction command first, establish the causal mechanism, and follow `resources/execution-protocol.md` for the diagnosis record when an OMA workflow is active. Add the regression test and re-run the failing check plus related tests.

### Resource scope
| Scope | Resource target |
|-------|-----------------|
| `CODEBASE` | Failing source, tests, and related patterns |
| `LOCAL_FS` | Bug reports and result artifacts |
| `PROCESS` | Reproduction and verification commands |
| `MEMORY` | Hypotheses, root-cause notes, verification evidence |

### Preconditions
- A bug signal, symptom, or failing behavior is available.
- Relevant code and verification path can be inspected or the blocker is stated.

### Effects and side effects
- Mutates source/tests only as needed for the fix.
- May create bug documentation under `.agents/results/bugs/`.

### Guardrails
1. Reproduce first, then diagnose - never guess at fixes
2. Identify root cause, not just symptoms
3. Minimal fix: change only what's necessary
4. Every fix gets a regression test
5. Search for similar patterns elsewhere after fixing
6. Document in `.agents/results/bugs/`

### Code intelligence
Use the configured provider to locate the failing function, find callers, and search similar error patterns. Native search and scoped reads are supported fallbacks; see the shared capability contract.

## References
- Local code tools: `../_shared/core/code-intelligence.md` (code search/navigation)

- Execution steps (follow for the selected task): `resources/execution-protocol.md`
- Checklist (pre-submit self-verification): `resources/checklist.md`
- Error recovery: `resources/error-playbook.md`
- Bug report template: `resources/bug-report-template.md`
- Common patterns: `resources/common-patterns.md`
- Debugging checklist (investigation guide, used during Steps 1-2): `resources/debugging-checklist.md`
- Context loading: `../_shared/core/context-loading.md`
- Context budget: `../_shared/core/context-budget.md`
- Lessons learned: `../_shared/core/lessons-learned.md` (matching prior failure or requested retrospective)
- Observability handoff: `../oma-observability/SKILL.md` §Integrations — traces/logs by `trace_id`, 6-dim forensics

© First Fluke · MIT · first-fluke/oh-my-agent

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

Все скиллы по теме «Тесты и QA» →
08-debug AI-Driven Dev Скилл 08-debug для разбора багов: воспроизводит известную ошибку вместе с тестом и правкой, а неясную причину ищет перебором гипотез. CX Codex +1 ★ 571звёзд репо bugfix ulpi-io Скилл bugfix для Claude Code ведёт отладку: требует воспроизвести ошибку падающим тестом, найти первопричину и внести минимальную правку без ослабления проверок. CX Codex +1 176установок issue-tracer ZaxbyHub Скилл issue-tracer для Claude Code пошагово расследует баги: фиксирует воспроизведение тестами, проверяет устранение причины и готовит пулреквест. CX Codex +1 ★ 539звёзд репо debug jsmastery-pro Скилл debug запускает цикл поиска первопричины бага: воспроизводит сбой, изолирует место ошибки, проверяет гипотезы и готовит минимальное исправление. CX Codex +1 5 100установок ce-debug EveryInc Скилл ce-debug для Claude Code находит причину ошибки или медленной работы. Запускается по просьбе разобраться со сбоем или исправить его. CX Codex +1 3 700установок gjalla-debug gjalla Скилл gjalla-debug для поиска первопричины бага с доказательствами до того, как агент предложит исправление. Работает с Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. CX Codex +1 357установок

Из того же набора69

Весь набор →
oma-docs Сверяет ссылки в документации, обновляет тексты под изменения в коде и находит рассинхрон в переводах. Работает через CLI oma docs или ручной парсинг ссылок. CX Codex +1 ★ 1 472звёзд репо oma-scm Скилл oma-scm для Claude Code выполняет Git-операции: коммиты, ветки, слияния и разрешение конфликтов. Он задаёт явную область действий и предусматривает возможность отката. CX Codex +1 ★ 1 472звёзд репо oma-skill-creation Скилл oma-skill-creation создаёт и редактирует скиллы OMA в формате SSL-lite для Claude Code и Codex. Включается при проектировании структуры .agents/skills/{name}/SKILL.md, настройке роутинга и проверке линтером. CX Codex +1 ★ 1 472звёзд репо oma-mobile Скилл oma-mobile для мобильной разработки: помогает собрать экран или виджет на Flutter или React Native, подключить камеру, GPS, пуши и офлайн-режим. CX Codex +1 ★ 1 472звёзд репо oma-qa Скилл oma-qa для Claude Code и Codex проверяет изменения по безопасности, производительности, доступности и корректности. Анализирует diff, запускает подходящие проверки и выдаёт воспроизводимые замечания с исправлениями. CX Codex +1 ★ 1 472звёзд репо oma-search Скилл oma-search для Claude Code и Codex маршрутизирует поисковые запросы по документации, веб-страницам и удалённому коду. Отбирает подходящий канал выдачи и возвращает ответы со ссылками на первоисточники. CX Codex +1 ★ 1 472звёзд репо oma-pm Скилл oma-pm превращает требования к продукту в план задач с приоритетами, зависимостями и критериями приёмки. Пригодится перед передачей работы специализированным агентам. CX Codex +1 ★ 1 472звёзд репо oma-brainstorm Скилл oma-brainstorm для Claude Code исследует замысел, ограничения и варианты решения до планирования или разработки. Уточняет неясную идею. CX Codex +1 ★ 1 472звёзд репо

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

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