# oh-my-agent: Portable Multi-Agent Harness [![npm version](https://img.shields.io/npm/v/oh-my-agent?color=cb3837&logo=npm)](https://www.npmjs.com/package/oh-my-agent) [![npm downloads](https://img.shields.io/npm/dm/oh-my-agent?color=cb3837&logo=npm)](https://www.npmjs.com/package/oh-my-agent) [![GitHub stars](https://img.shields.io/github/stars/first-fluke/oh-my-agent?style=flat&logo=github)](https://github.com/first-fluke/oh-my-agent) [![License](https://img.shields.io/github/license/first-fluke/oh-my-agent)](https://github.com/first-fluke/oh-my-agent/blob/main/LICENSE) [![Last Updated](https://img.shields.io/github/last-commit/first-fluke/oh-my-agent?label=updated&logo=git)](https://github.com/first-fluke/oh-my-agent/commits/main) [English](../README.md) | [한국어](./README.ko.md) | [中文](./README.zh.md) | [Português](./README.pt.md) | [日本語](./README.ja.md) | [Français](./README.fr.md) | [Español](./README.es.md) | [Nederlands](./README.nl.md) | [Polski](./README.pl.md) | [Deutsch](./README.de.md) | [Tiếng Việt](./README.vi.md) | [ภาษาไทย](./README.th.md) Когда-нибудь хотели, чтобы у вашего ИИ-ассистента были коллеги? Именно это и делает oh-my-agent. Вместо того чтобы один ИИ делал все (и терялся на полпути), oh-my-agent распределяет работу между **специализированными агентами**: frontend, backend, architecture, QA, PM, DB, mobile, infra, debug, design и другими. Каждый глубоко знает свою область, имеет свои инструменты и чеклисты и не лезет в чужую зону. Работает со всеми основными AI IDE: Antigravity, Claude Code, Codex, Cursor, Grok Build, Kimi Code, OpenCode, Pi, Qwen Code и другими. ## Быстрый старт ```bash # macOS / Linux — автоматически установит bun, uv & serena, если их нет curl -fsSL https://raw.githubusercontent.com/first-fluke/oh-my-agent/main/cli/install.sh | bash ``` ```powershell # Windows (PowerShell) — автоматически установит bun, uv & serena, если их нет irm https://raw.githubusercontent.com/first-fluke/oh-my-agent/main/cli/install.ps1 | iex ``` ```bash # Или вручную (любая ОС, требуется bun + uv + serena) bunx oh-my-agent@latest ``` ### Установка через Agent Package Manager

Agent Package Manager (APM) от Microsoft: дистрибуция только со скилами. Нажмите, чтобы развернуть.

> Не путайте с APM (Application Performance Monitoring) из `oma-observability`. ```bash # Все скилы, разворачиваются во все обнаруженные runtime # (.claude, .cursor, .codex, .opencode, .github, .agents) apm install first-fluke/oh-my-agent # Один скил apm install first-fluke/oh-my-agent/.agents/skills/oma-frontend ``` APM поставляет только скилы. Для workflow, правил, `oma-config.yaml`, хуков детекции ключевых слов и CLI `oma agent:spawn` используйте `bunx oh-my-agent@latest`. На один проект выбирайте один способ дистрибуции, иначе всё разъедется.

Выберите пресет, и готово: | Пресет | Что получаете | |--------|-------------| | ✨ All | Все агенты и навыки | | 🌐 Fullstack | architecture + frontend + backend + db + pm + qa + debug + brainstorm + scm | | 🎨 Frontend | architecture + frontend + pm + qa + debug + brainstorm + scm | | ⚙️ Backend | architecture + backend + db + pm + qa + debug + brainstorm + scm | | 📱 Mobile | architecture + mobile + pm + qa + debug + brainstorm + scm | | 🚀 DevOps | architecture + tf-infra + dev-workflow + pm + qa + debug + brainstorm + scm | ## Работает с любым агентом `oh-my-agent` хранит `.agents/` как единый источник истины (SSOT) и проецирует его в нативный layout каждого runtime. Поэтому все поддерживаемые инструменты используют одни и те же skills, workflows и правила.

Claude Code _{нативный + адаптер}	Codex CLI _{нативный + адаптер}	Antigravity _{нативный SSOT}	Cursor _{нативный + адаптер}	Qwen Code _{нативный dispatch}	Reasonix _{нативная совместимость}
Pi _{нативная совместимость}	OpenCode _{нативная совместимость}	Amp _{нативная совместимость}	GitHub Copilot _{skills через symlink}	Grok Build _{нативные hooks}	Kiro CLI _{нативные hooks + agents}

_{& ещё}

## Ваша команда агентов | Агент | Что делает | |-------|-------------| | **oma-academic-writer** | Пишет, редактирует и проверяет академические тексты до уровня публикации | | **oma-architecture** | Анализирует архитектурные компромиссы и определяет границы модулей с помощью ADR/ATAM/CBAM | | **oma-backend** | Строит и защищает ваши API на Python, Node.js или Rust | | **oma-brainstorm** | Помогает обдумать идеи до того, как вы приступите к реализации | | **oma-coordination** | Пошагово направляет ручную координацию агентов PM, фронтенда, бэкенда, мобильной разработки и QA | | **oma-db** | Проектирует схемы, миграции, индексы и векторные хранилища | | **oma-debug** | Находит корневую причину, исправляет баг и пишет регрессионный тест | | **oma-deepsec** | Сканирует код на уязвимости и блокирует рискованные pull request'ы | | **oma-design** | Строит дизайн-системы с токенами, доступностью и адаптивными макетами | | **oma-dev-workflow** | Автоматизирует CI/CD, релизы и задачи в monorepo | | **oma-docs** | Проверяет документацию на битые ссылки и выявляет страницы, затронутые изменениями кода | | **oma-frontend** | Строит интерфейс на React/Next.js, TypeScript, Tailwind CSS v4 и shadcn/ui | | **oma-hwp** | Конвертирует файлы HWP, HWPX и HWPML в Markdown | | **oma-image** | Генерирует изображения через несколько AI-провайдеров одновременно | | **oma-market** | Исследует рынок по сигналам сообществ и структурирует результаты через SWOT, Porter's 5F и PESTEL | | **oma-mobile** | Разрабатывает кроссплатформенные мобильные приложения на Flutter | | **oma-observability** | Маршрутизирует задачи наблюдаемости по метрикам, логам, трейсам, SLO и форензике инцидентов | | **oma-orchestrator** | Запускает несколько агентов параллельно через CLI | | **oma-pdf** | Конвертирует PDF-файлы в Markdown | | **oma-pm** | Планирует задачи, декомпозирует требования и определяет API-контракты | | **oma-qa** | Проверяет код на уязвимости OWASP, проблемы производительности и доступности | | **oma-recap** | Преобразует историю диалогов в тематические сводки о проделанной работе | | **oma-refactor** | Рефакторит код без изменения поведения, используя горячие точки, характеризационные тесты и отдельные refactor-коммиты | | **oma-scholar** | Ищет академическую литературу и помогает проводить рецензирование | | **oma-scm** | Управляет ветками, слияниями, worktree и Conventional Commits | | **oma-search** | Направляет каждый запрос к лучшему источнику и оценивает степень доверия к результату | | **oma-skill-creator** | Пишет и проверяет новые OMA-скилы в формате SSL-lite | | **oma-slide** | Генерирует характерные HTML-презентационные деки с богатой анимацией и экспортирует в PDF/PNG/PPTX | | **oma-tf-infra** | Разворачивает мультиоблачную инфраструктуру с помощью Terraform | | **oma-translator** | Переводит между языками так, будто текст изначально написан носителем | | **oma-video** | Создаёт короткие, обучающие и демонстрационные видео через пайплайн Remotion, работающий и без ключей | | **oma-voice** | Генерирует озвучку и транскрибирует аудио на устройстве — без облака | ## Как это работает Просто пишите. Опишите, что вам нужно, и oh-my-agent сам разберется, каких агентов подключить. ``` Вы: "Собери TODO-приложение с аутентификацией пользователей" → PM планирует работу → Backend строит API аутентификации → Frontend строит UI на React → DB проектирует схему → QA проверяет все → Готово: скоординированный, проверенный код ``` Или используйте slash-команды для структурированных воркфлоу: | Шаг | Команда | Что делает | |-----|---------|-------------| | 0 | `/deepinit` | Разбирает вашу кодовую базу в AGENTS.md, ARCHITECTURE.md и docs | | 1 | `/brainstorm` | Прорабатывает идеи вместе с вами, пока вы не решили строить | | 2 | `/architecture` | Взвешивает компромиссы дизайна и проводит чёткие границы модулей | | 2 | `/design` | Строит вашу дизайн-систему с токенами, доступностью и адаптивной вёрсткой | | 2 | `/plan` | Разбивает вашу фичу на приоритизированные задачи | | 3 | `/work` | Строит вашу фичу шаг за шагом силами нескольких агентов | | 3 | `/orchestrate` | Запускает несколько агентов параллельно, чтобы быстрее собрать вашу фичу | | 3 | `/ultrawork` | Строит вашу фичу через пять фаз качества и одиннадцать ревью-гейтов | | 3 | `/ralph` | Повторяет `/ultrawork`, пока независимый проверяющий не пройдёт все критерии | | 4 | `/review` | Проверяет ваш код на проблемы безопасности, производительности и доступности | | 4 | `/deepsec` | Проводит глубокое сканирование безопасности и блокирует рискованные pull request'ы | | 5 | `/debug` | Находит корневую причину, чинит баг и пишет регрессионный тест | | 5 | `/docs` | Проверяет вашу документацию на битые ссылки и правит те, что затронуты изменениями кода | | 6 | `/scm` | Управляет вашими ветками, слияниями и Conventional Commits | | - | `/schedule` | Планирует задание агента на запуск по повторяющемуся интервалу | **Автодетекция**: Slash-команды не обязательны. Слова вроде «архитектура», «plan», «review» и «debug» в сообщении (на 11 языках!) автоматически активируют нужный воркфлоу. ### Модели по агенту Каждый агент может указывать собственную модель и `effort` через `.agents/oma-config.yaml`. Доступные runtime profiles: `antigravity`, `claude`, `codex`, `cursor`, `kiro`, `mixed`, `qwen`. Проверьте итоговую auth-матрицу командой `oma doctor --profile`. Полное руководство: [web/docs/guide/per-agent-models.md](../web/docs/guide/per-agent-models.md). ## Почему oh-my-agent? > [Подробнее →](https://github.com/first-fluke/oh-my-agent/issues/155#issuecomment-4142133589) - **Портативный**: `.agents/` путешествует с вашим проектом, не привязан к одной IDE - **Ролевой**: агенты смоделированы как настоящая инженерная команда, а не куча промптов - **Экономит токены**: двухуровневый дизайн навыков экономит ~75% токенов - **Качество прежде всего**: Charter preflight, quality gates и ревью-воркфлоу из коробки: - `oma verify ` — 14 детерминированных проверок на тип агента (TypeScript strict, тесты, raw SQL, захардкоженные секреты, Flutter analyze, inline styles, нарушение scope, charter alignment …) - `session.quota_cap` — лимиты токенов / spawn / по вендору на сессию в `oma-config.yaml`; Step 5 `orchestrate` блокирует следующий spawn при превышении - workflow `ralph` — независимый JUDGE перепроверяет каждый criterion на каждой итерации, чтобы поймать тихие регрессии; кеширование для тестов >30с - Exploration Loop — после 2 retry `orchestrate` параллельно spawn'ит варианты гипотез и оставляет с лучшим скором - Авто-роутинг монорепо — `detectWorkspace` читает pnpm / nx / turbo / lerna и направляет каждого агента в его workspace - **Мультивендорный**: комбинируйте Antigravity, Claude, Codex, Cursor, Kiro и Qwen для разных типов агентов - **Наблюдаемый**: дашборды в терминале и в вебе для мониторинга в реальном времени ## Архитектура ```mermaid flowchart TD subgraph Workflows["Workflows"] direction TB W0["/brainstorm"] W1["/work"] W1b["/ultrawork"] W2["/orchestrate"] W3["/architecture"] W4["/plan"] W5["/review"] W6["/debug"] W7["/deepinit"] W8["/design"] end subgraph Orchestration["Orchestration"] direction TB PM[oma-pm] ORC[oma-orchestrator] end subgraph Domain["Domain Agents"] direction TB ARC[oma-architecture] FE[oma-frontend] BE[oma-backend] DB[oma-db] MB[oma-mobile] DES[oma-design] TF[oma-tf-infra] end subgraph Quality["Quality"] direction TB QA[oma-qa] DBG[oma-debug] end Workflows --> Orchestration Orchestration --> Domain Domain --> Quality Quality --> SCM([oma-scm]) ``` ## Узнать больше - **[Подробная документация](./AGENTS_SPEC.md)**: полная техническая спецификация и архитектура - **[Поддерживаемые агенты](./SUPPORTED_AGENTS.md)**: матрица поддержки агентов по IDE - **[Веб-документация](https://first-fluke.github.io/oh-my-agent/)**: гайды, туториалы и справочник CLI ## Спонсоры Этот проект поддерживается благодаря нашим щедрым спонсорам. > **Нравится проект?** Поставьте звезду! > > ```bash > gh api --method PUT /user/starred/first-fluke/oh-my-agent > ``` > > Попробуйте наш оптимизированный стартовый шаблон: [fullstack-starter](https://github.com/first-fluke/fullstack-starter)

### 🚀 Champion ### 🛸 Booster ### ☕ Contributor [Стать спонсором →](https://github.com/sponsors/first-fluke) Полный список поддерживающих доступен в [SPONSORS.md](../SPONSORS.md). ## Star History [![Star History Chart](https://api.star-history.com/svg?repos=first-fluke/oh-my-agent&type=date&legend=bottom-right)](https://www.star-history.com/#first-fluke/oh-my-agent&type=date&legend=bottom-right) ## Список литературы - Liang, Q., Wang, H., Liang, Z., & Liu, Y. (2026). *From skill text to skill structure: The scheduling-structural-logical representation for agent skills* (Version 4) [Preprint]. arXiv. https://doi.org/10.48550/arXiv.2604.24026 - Chen, C., Yu, Q., Gu, Y., Huang, Z., Li, H., Liu, H., Liu, S., Liu, J., Peng, D., Wang, J., Yan, Z., Meng, F., Qin, E., Che, C., & Hu, M. (2026). *The scaling laws of skills in LLM agent systems* (Version 1) [Preprint]. arXiv. https://doi.org/10.48550/arXiv.2605.16508 - Yang, Y., Gong, Z., Huang, W., Yang, Q., Zhou, Z., Huang, Z., Li, Y., Gao, X., Dai, Q., Liu, B., Qiu, K., Yang, Y., Chen, D., Yang, X., & Luo, C. (2026). *SkillOpt: Executive strategy for self-evolving agent skills* [Preprint]. arXiv. https://doi.org/10.48550/arXiv.2605.23904 - Huang, Z., Xu, J., Yang, Y., Gong, Z., Yang, Q., Tian, M., Wang, X., Lv, C., Gao, X., Dai, Q., Liu, B., Qiu, K., Yang, X., Chen, D., Zheng, X., & Luo, C. (2026). *From raw experience to skill consumption: A systematic study of model-generated agent skills* [Preprint]. arXiv. https://doi.org/10.48550/arXiv.2605.23899 ## Лицензия MIT