Как Использовать oh-my-agent

Не знаете, с чего начать? Введите /work и опишите, что хотите построить.

Быстрый Старт

1. Откройте проект в IDE с ИИ (Claude Code, Gemini, Cursor и т.д.)
2. Навыки автоматически определяются из .agents/skills/
3. Начните общение — опишите, что вам нужно

Вот и всё. oh-my-agent позаботится об остальном.

---

Пример 1: Простая Одиночная Задача

Вы вводите:

"Создай компонент формы логина с полями email и пароля на Tailwind CSS"

Что происходит:

• Активируется навык oma-frontend
• Загружает свой протокол выполнения и ресурсы tech-stack по требованию
• Вы получаете React-компонент с TypeScript, Tailwind, валидацией формы и тестами

Никаких слэш-команд не нужно. Просто опишите, что хотите.

Пример 2: Мультидоменный Проект

Вы вводите:

"Построй приложение TODO с аутентификацией пользователей"

Что происходит:

1. Определение ключевых слов видит мультидоменную задачу → предлагает /work
2. PM-агент планирует работу: API авторизации, схема БД, фронтенд UI, скоуп QA
3. Вы запускаете агентов:

   oma agent:spawn backend "JWT authentication API" session-01 -w ./apps/api &
   oma agent:spawn frontend "Login and TODO UI" session-01 -w ./apps/web &
   wait

4. Агенты работают параллельно — каждый в своём workspace
5. QA-агент проверяет — аудит безопасности, проверка интеграции
6. Вы итерируете — перезапускайте агентов с уточнениями при необходимости

Пример 3: Исправление Бага

Вы вводите:

"Есть баг — клик по кнопке логина показывает 'Cannot read property map of undefined'"

Что происходит:

1. oma-debug активируется автоматически (ключевое слово: «баг»)
2. Корневая причина найдена — компонент вызывает map на todos до загрузки данных
3. Исправление применено — состояния загрузки и проверки на null
4. Написан регрессионный тест
5. Аналогичные паттерны найдены и проактивно исправлены в 3 других компонентах

Пример 4: Дизайн-Система

Вы вводите:

"Разработай дизайн тёмной премиум-лендинг страницы для моего SaaS-продукта"

Что происходит:

1. oma-design активируется (ключевые слова: «дизайн», «лендинг»)
2. Собирает контекст — аудитория, бренд, эстетическое направление
3. Предлагает 2-3 направления дизайна с вариантами цветов, типографики и макета
4. Генерирует DESIGN.md с токенами, паттернами компонентов и правилами доступности
5. Проводит аудит — адаптивность, WCAG, эвристики Нильсена
6. Готово для реализации через oma-frontend

Пример 5: Параллельное Выполнение через CLI

# Один агент
oma agent:spawn backend "Implement JWT auth API" session-01

# Несколько агентов параллельно
oma agent:spawn backend "Auth API + DB migration" session-01 -w ./apps/api &
oma agent:spawn frontend "Login form + error states" session-01 -w ./apps/web &
oma agent:spawn mobile "Auth screens + biometrics" session-01 -w ./apps/mobile &
wait

# Мониторинг в реальном времени
oma dashboard        # UI в терминале
oma dashboard:web    # веб UI на http://localhost:9847

---

Команды Workflow

Введите их в вашей IDE с ИИ для запуска структурированных процессов:

Команда	Что Делает	Когда Использовать
/brainstorm	Свободная генерация идей	Перед выбором подхода
/plan	PM-декомпозиция задач → .agents/results/plan-{sessionId}.json	Перед началом сложной фичи
/exec-plan	Выполнить существующий план пошагово	После /plan
/work	Пошаговая мультидоменная координация	Фичи, охватывающие несколько агентов
/orchestrate	Автоматическое параллельное выполнение	Крупные проекты, максимальный параллелизм
/ultrawork	5-фазный workflow качества (11 контрольных точек)	Доставка максимального качества
/review	Аудит безопасности + производительности + доступности	Перед слиянием
/debug	Структурированная отладка корневой причины	Исследование багов
/design	7-фазный workflow дизайна → DESIGN.md	Создание дизайн-систем
/scm	Conventional commit с анализом type/scope	Фиксация изменений
/tools	Управление серверами MCP	Добавление внешних инструментов
/stack-set	Настройка tech stack	Установка предпочтений языков/фреймворков
/deepinit	Полная инициализация проекта	Настройка в существующей кодовой базе

---

Автоопределение (Без Слэш-Команд)

oh-my-agent определяет ключевые слова на 11 языках и автоматически активирует workflows:

Вы Говорите	Какой Workflow Активируется
"plan the auth feature"	/plan
"버그 수정해줘"	/debug
"do everything in parallel"	/orchestrate
"レビューして"	/review
"diseña la página"	/design
"brainstorm some ideas"	/brainstorm

Вопросы вроде «what is orchestrate?» фильтруются — они не запустят workflows случайно.

---

Доступные Навыки

Навык	Лучше Всего Для	Результат
oma-pm	«запланируй это», «декомпозируй»	.agents/results/plan-{sessionId}.json
oma-frontend	UI, компоненты, стилизация	React-компоненты, тесты
oma-backend	API, базы данных, авторизация	Эндпоинты, модели, тесты
oma-db	Схема, ERD, миграции	Дизайн схемы, оптимизация запросов
oma-mobile	Мобильные приложения	Flutter-экраны, управление состоянием
oma-design	UI/UX, дизайн-системы	DESIGN.md с токенами
oma-brainstorm	Генерация идей, исследование	Документ дизайна
oma-qa	Безопасность, производительность, a11y	QA-отчёт с приоритизированными исправлениями
oma-debug	Баги, ошибки, краши	Исправленный код + регрессионные тесты
oma-tf-infra	Облачная инфраструктура	Модули Terraform
oma-dev-workflow	CI/CD, автоматизация	Конфигурации пайплайнов
oma-translator	Перевод	Естественный многоязычный контент
oma-orchestrator	Параллельное выполнение	Результаты агентов
oma-scm	Git-коммиты	Conventional commits

---

Дашборды

Дашборд в Терминале

oma dashboard

Живая таблица со статусом сессии, состояниями агентов, ходами и последней активностью. Отслеживает .serena/memories/ для обновлений в реальном времени.

Веб-Дашборд

oma dashboard:web
# → http://localhost:9847

Возможности:

• Обновления в реальном времени через WebSocket
• Автопереподключение при обрывах
• Статус сессии с цветными индикаторами агентов
• Лог активности из файлов прогресса и результатов

Рекомендуемая Расстановка

Используйте 3 терминала:

1. Дашборд (oma dashboard)
2. Команды запуска агентов
3. Логи тестов/сборки

---

Советы

1. Будьте конкретны — «Построй TODO-приложение с JWT auth, фронтенд React, бэкенд Express» лучше, чем «сделай приложение»
2. Используйте workspace — -w ./apps/api не даёт агентам конфликтовать
3. Зафиксируйте контракты сначала — выполните /plan перед параллельным запуском
4. Мониторьте активно — дашборды выявляют проблемы до слияния
5. Итерируйте перезапусками — уточняйте промпты агентов вместо того, чтобы начинать заново
6. Начинайте с /work — когда не уверены, какой workflow использовать

---

Устранение Неполадок

Проблема	Решение
Навыки не определяются в IDE	Проверьте наличие .agents/skills/ с файлами SKILL.md, перезапустите IDE
CLI не найден	which gemini / which claude — установите недостающие
Агенты создают конфликтующий код	Используйте отдельные workspace (-w), проверяйте результаты, перезапускайте с исправлениями
Дашборд показывает «No agents detected»	Агенты ещё не записали в .serena/memories/ — подождите или проверьте session ID
Веб-дашборд не запускается	Сначала выполните bun install
QA-отчёт содержит 50+ проблем	Фокусируйтесь на CRITICAL/HIGH, задокументируйте остальное на потом

---

Для интеграции в существующие проекты смотрите Руководство по Интеграции.