OpenCode oh-my-openagent: руководство по использованию

Oh My OpenAgent(сокращённоOmO) — это плагин для улучшения AI-ассистента программирования с открытым исходным кодом, ранее называвшийсяoh-my-opencode。

oh-my-openagent работает поверх OpenCode, инструмента AI-программирования, превращая его в11 профессиональных AI-агентов, образующих команду разработки.

Объяснение в одном предложении:

Вы отправляете запрос → OmO автоматически организует параллельную работу нескольких AI → В несколько раз быстрее, чем один AI

В настоящее время имеет на GitHub54k+ звёзд, это самый популярный плагин OpenCode.

Установка

Скопируйте и вставьте следующий промпт в ваш LLM-инструмент (OpenCode, Claude Code, AmpCode, Cursor и т. д.):

按照此链接说明安装并配置 oh-my-opencode:https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md

После выполнения он установится сам. Во время установки могут быть параметры настройки API-ключа; вы можете настроить их или нет:


Познакомьтесь с 11 участниками ИИ-команды (агентами)

В OmO встроено 11 специализированных агентов, каждый со своей ролью:

Основные агенты

Агент Роль Модель по умолчанию Когда использовать
Sisyphus Главный координатор, универсальный разработчик Claude Opus Точка входа для всех задач, автоматически оркеструет других агентов
Prometheus Стратегический планировщик Claude Opus / GPT-5.4 Планирование сложных задач
Атлас Управление задачами Todo Kimi K2.5 Отслеживание прогресса многошаговых задач

Профессиональные агенты

Агент Роль Модель по умолчанию Специализируется на
Гефест Автономный исполнитель глубокого уровня GPT-5.3-codex Длительные, высокоинтенсивные независимые задачи по программированию
Oracle Консультант по архитектуре / эксперт по отладке GPT-5.4 Проектирование систем, поиск сложных ошибок
Momus Высокоточный проверяющий GPT-5.4 Проверка кода, верификация вывода
Metis Проверка плана Claude Opus Проверить, есть ли в плане Prometheus упущения

Агенты инструментального типа (быстрые, недорогие)

Агент Роль Модель по умолчанию Почему использовать дешёвые модели
Исследование Быстрый поиск по кодовой базе MiniMax / Grok Code Fast Задачи поиска не требуют высокого интеллекта; скорость важнее
Библиотекарь Извлечение документов/кода MiniMax (бесплатно) Извлечение документов не требует глубоких рассуждений
Мультимодальный наблюдатель Анализ скриншотов/визуальный анализ Kimi K2.5 Kimi отлично справляется с мультимодальным пониманием

💡 Совет для начинающих: Вам не нужно вручную выбирать агентов. Sisyphus автоматически подберёт подходящую комбинацию агентов в зависимости от типа вашей задачи.


Три режима работы

Режим 1: ultrawork (самый простой)

Добавить в запросultraworkилиulw, всё автоматизировано:

ultrawork 帮我把这个 React 组件改成 TypeScript

Подходит для: ежедневных задач разработки, сценариев, где вы хотите, чтобы ИИ выполнял всё автоматически.

Режим 2: режим планирования Prometheus (самый точный)

нажмитеклавишу Tab, чтобы войти в режим Prometheus. ИИ сначала поймёт ваши требования через вопросы и ответы, сгенерирует подробный план выполнения и начнёт выполнение после вашего подтверждения.

Рабочий процесс:

  1. нажмитеTabПереключитесь в режим Prometheus
  2. Опишите свои требования; ИИ задаст вам несколько уточняющих вопросов
  3. ИИ создаёт план выполнения, вы подтверждаете
  4. Enter/start-workчтобы начать выполнение

Подходит для: разработки сложных функций, рефакторинга архитектуры и других сценариев, требующих точного планирования.

Режим 3: обычный разговор (самый гибкий)

Введите свой вопрос или требование напрямую, не добавляя никаких ключевых слов:

解释一下 src/auth.ts 里的 JWT 验证逻辑

Подходит для: лёгких задач, таких как вопросы, объяснение кода и небольшие изменения.


Сведения о файле конфигурации

OmO имеет два файла конфигурации с разными приоритетами:

  • Конфигурация уровня проекта (более высокий приоритет):.opencode/oh-my-opencode.jsonc
  • Конфигурация уровня пользователя (глобальное значение по умолчанию):~/.config/opencode/oh-my-opencode.jsonc

Файлы конфигурации поддерживают комментарии (формат JSONC) и автодополнение JSON Schema:

{
  "$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/dev/assets/oh-my-opencode.schema.json",
  
  "agents": {
    // 主协调 Agent,建议用 Claude Opus 系列或 Kimi
    "sisyphus": {
      "model": "anthropic/claude-opus-4-6"
    },
    // 架构顾问,建议用 GPT 系列
    "oracle": {
      "model": "openai/gpt-5.4",
      "variant": "high"
    }
  }
}

Совет для новичков: Не изменяйте конфигурацию сразу после установки; настройки по умолчанию уже хороши.


Краткий справочник по распространённым командам

Команда Описание
opencode Запустить OmO
bunx oh-my-opencode install Установить/перенастроить плагин
bunx oh-my-opencode doctor ⟦5⟧Диагностировать проблемы конфигурации
opencode auth login Войти в аккаунт провайдера ИИ
opencode models Просмотреть все доступные модели
bunx oh-my-opencode refresh-model-capabilities Обновить кэш возможностей моделей

В интерфейсе диалога:

Сочетание клавиш/Команда Описание
Tab Переключиться в режим планирования Prometheus
/start-work Начать выполнение плана в режиме Prometheus
ultrawork / ulw Добавьте в промпт, чтобы активировать полнофункциональный параллельный режим

Устранение распространённых проблем

Вопрос: После установки запускopencodeне отображает функции OmO

Решение: Проверьте, правильно ли зарегистрирован плагин в файле конфигурации:

cat ~/.config/opencode/opencode.json

Убедитесьpluginполе содержит"oh-my-opencode". Если нет, запустите повторноbunx oh-my-opencode install。

Вопрос: Предупреждение во время выполнения "Using legacy package name"

Решение: Изменитьopencode.jsonназвание плагина в ... с"oh-my-opencode"в"oh-my-openagent":

{
  "plugin": ["oh-my-openagent"]
}

Вопрос: Sisyphus Agent работает плохо, ощущается так же, как обычный Claude

Причина: Возможно, вы не используете модель Claude Opus или не добавляетеultrawork。

Решение:

  1. Убедитесь, что вы вошли в аккаунт Claude Pro/Max
  2. Addultraworkключевое слово в промпт
  3. Запуститеbunx oh-my-opencode doctorчтобы проверить конфигурацию модели

Вопрос: Задача останавливается на полпути

Решение: Продолжайте отправлять промптыultrawork 继续之前的任务, Sisyphus возобновит прогресс через систему Todo.

Вопрос: Хотите отключить анонимные данные телеметрии

OmO по умолчанию включает анонимную телеметрию (использует PostHog, данные хешируются). Чтобы отключить её:

export OMO_SEND_ANONYMOUS_TELEMETRY=0
# 或
export OMO_DISABLE_POSTHOG=1
Другие расширения