Skip to content

Latest commit

 

History

History
346 lines (241 loc) · 21.1 KB

File metadata and controls

346 lines (241 loc) · 21.1 KB

English | 한국어 | 中文 | 日本語 | Español | Tiếng Việt | Português | Русский | Türkçe | Deutsch | Français | Italiano

oh-my-claudecode

npm version npm downloads GitHub stars License: MIT Sponsor Discord

Мультиагентная оркестрация для Claude Code. Нулевой порог вхождения.

Не изучайте Claude Code. Просто используйте OMC.

НачатьДокументацияРуководство по миграции


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

Шаг 1: Установка

/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode
/plugin install oh-my-claudecode

Шаг 2: Настройка

/oh-my-claudecode:omc-setup

Шаг 3: Создайте что-нибудь

autopilot: build a REST API for managing tasks

Вот и всё. Всё остальное происходит автоматически.

Team Mode (Рекомендуется)

Начиная с v4.1.7, Team — это каноническая поверхность оркестрации в OMC. Устаревшие точки входа, такие как swarm и ultrapilot, по-прежнему поддерживаются, но теперь направляются в Team под капотом.

/oh-my-claudecode:team 3:executor "fix all TypeScript errors"

Team работает как поэтапный pipeline:

team-plan → team-prd → team-exec → team-verify → team-fix (loop)

Включите нативные команды Claude Code в ~/.claude/settings.json:

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

Если teams отключены, OMC предупредит вас и переключится на выполнение без Team, если это возможно.

Примечание: Название пакета — Проект использует бренд oh-my-claudecode (репозиторий, плагин, команды), но npm-пакет публикуется как oh-my-claude-sisyphus. Если вы устанавливаете CLI-инструменты через npm/bun, используйте npm install -g oh-my-claude-sisyphus.

Обновление

# 1. Обновите плагин
/plugin install oh-my-claudecode

# 2. Перезапустите setup для обновления конфигурации
/oh-my-claudecode:omc-setup

Если после обновления возникли проблемы, очистите старый кэш плагина:

/oh-my-claudecode:omc-doctor

Ваш Claude только что получил суперсилу.

oh-my-claudecode


Почему oh-my-claudecode?

  • Настройка не требуется — Работает сразу из коробки с умными значениями по умолчанию
  • Team-first оркестрация — Team является каноническим мультиагентным интерфейсом (swarm/ultrapilot — фасады совместимости)
  • Интерфейс на естественном языке — Не нужно запоминать команды, просто описывайте, что вам нужно
  • Автоматическая параллелизация — Сложные задачи распределяются между специализированными агентами
  • Настойчивое выполнение — Не сдаётся, пока работа не будет проверена и завершена
  • Оптимизация затрат — Умная маршрутизация моделей экономит 30-50% токенов
  • Обучение на опыте — Автоматически извлекает и переиспользует паттерны решения задач
  • Видимость в реальном времени — HUD statusline показывает, что происходит под капотом

Возможности

Режимы оркестрации

Множество стратегий для разных сценариев — от оркестрации через Team до рефакторинга с экономией токенов. Подробнее →

Режим Описание Применение
Team (рекомендуется) Канонический поэтапный pipeline (team-plan → team-prd → team-exec → team-verify → team-fix) Координированные агенты, работающие над общим списком задач
Autopilot Автономное выполнение (один ведущий агент) Сквозная разработка фич с минимальной церемонией
Ultrawork Максимальный параллелизм (без Team) Параллельные исправления/рефакторинг, когда Team не нужен
Ralph Режим настойчивости с циклами verify/fix Задачи, которые должны быть полностью завершены (без тихих частичных результатов)
Ecomode Токен-эффективная маршрутизация Бюджетно-ориентированная итерация
Pipeline Последовательная поэтапная обработка Многоступенчатые трансформации со строгим порядком
Swarm / Ultrapilot (устаревшие) Фасады совместимости, направляющие в Team Существующие рабочие процессы и старая документация

Интеллектуальная оркестрация

  • 32 специализированных агента для архитектуры, исследований, дизайна, тестирования, data science
  • Умная маршрутизация моделей — Haiku для простых задач, Opus для сложных рассуждений
  • Автоматическое делегирование — Правильный агент для правильной задачи, каждый раз

Опыт разработчика

  • Магические ключевые словаralph, ulw, eco, plan для явного управления
  • HUD statusline — Метрики оркестрации в реальном времени в строке состояния
  • Обучение навыкам — Извлечение переиспользуемых паттернов из сессий
  • Аналитика и отслеживание затрат — Понимание использования токенов по всем сессиям

Пользовательские навыки

Выучите один раз — используйте всегда. OMC извлекает ценные знания отладки в портативные файлы навыков, которые автоматически внедряются при необходимости.

Область проекта Область пользователя
Путь .omc/skills/ ~/.omc/skills/
Доступно Команде (под контролем версий) Всем вашим проектам
Приоритет Выше (переопределяет пользовательскую область) Ниже (резервный)
# .omc/skills/fix-proxy-crash.md
---
name: Fix Proxy Crash
description: aiohttp proxy crashes on ClientDisconnectedError
triggers: ["proxy", "aiohttp", "disconnected"]
source: extracted
---
Оберните обработчик в server.py:42 в try/except ClientDisconnectedError...

Управление навыками: /skill list | add | remove | edit | search Автообучение: /learner извлекает переиспользуемые паттерны со строгими критериями качества Автовнедрение: Подходящие навыки автоматически загружаются в контекст — ручной вызов не требуется

Полный список возможностей →


Магические ключевые слова

Опциональные ярлыки для опытных пользователей. Естественный язык работает без них.

Ключевое слово Эффект Пример
team Каноническая Team-оркестрация /oh-my-claudecode:team 3:executor "fix all TypeScript errors"
autopilot Полностью автономное выполнение autopilot: build a todo app
ralph Режим настойчивости ralph: refactor auth
ulw Максимальный параллелизм ulw fix all errors
eco Токен-эффективное выполнение eco: migrate database
plan Интервью для планирования plan the API
ralplan Итеративный консенсус планирования ralplan this feature
swarm Устаревшее ключевое слово (направляется в Team) swarm 5 agents: fix lint errors
ultrapilot Устаревшее ключевое слово (направляется в Team) ultrapilot: build a fullstack app

Примечания:

  • ralph включает ultrawork: при активации ralph mode автоматически включается параллельное выполнение ultrawork.
  • Синтаксис swarm N agents по-прежнему распознаётся для определения количества агентов, но в v4.1.7+ среда выполнения основана на Team.

Утилиты

Ожидание Rate Limit

Автоматическое возобновление сессий Claude Code при сбросе rate limit.

omc wait          # Проверить статус, получить рекомендации
omc wait --start  # Включить демон автовозобновления
omc wait --stop   # Отключить демон

Требуется: tmux (для обнаружения сессии)

Теги уведомлений (Telegram/Discord)

Вы можете настроить, кого отмечать, когда stop-коллбэки отправляют сводку сессии.

# Установить/заменить список тегов
omc config-stop-callback telegram --enable --token <bot_token> --chat <chat_id> --tag-list "@alice,bob"
omc config-stop-callback discord --enable --webhook <url> --tag-list "@here,123456789012345678,role:987654321098765432"

# Инкрементальные обновления
omc config-stop-callback telegram --add-tag charlie
omc config-stop-callback discord --remove-tag @here
omc config-stop-callback discord --clear-tags

Поведение тегов:

  • Telegram: alice нормализуется в @alice
  • Discord: поддерживает @here, @everyone, числовые ID пользователей и role:<id>
  • Коллбэки типа file игнорируют параметры тегов

Интеграция с OpenClaw

Пересылайте события сессий Claude Code на шлюз OpenClaw, чтобы обеспечить автоматические ответы и рабочие процессы через вашего агента OpenClaw.

Быстрая настройка (рекомендуется):

/oh-my-claudecode:configure-notifications
# → При запросе введите "openclaw" → выберите "OpenClaw Gateway"

Ручная настройка: создайте ~/.claude/omc_config.openclaw.json:

{
  "enabled": true,
  "gateways": {
    "my-gateway": {
      "url": "https://your-gateway.example.com/wake",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" },
      "method": "POST",
      "timeout": 10000
    }
  },
  "hooks": {
    "session-start": { "gateway": "my-gateway", "instruction": "Session started for {{projectName}}", "enabled": true },
    "stop":          { "gateway": "my-gateway", "instruction": "Session stopping for {{projectName}}", "enabled": true }
  }
}

Переменные окружения:

Переменная Описание
OMC_OPENCLAW=1 Включить OpenClaw
OMC_OPENCLAW_DEBUG=1 Включить отладочное логирование
OMC_OPENCLAW_CONFIG=/path/to/config.json Переопределить путь к файлу конфигурации

Поддерживаемые события хуков (6 активных в bridge.ts):

Событие Триггер Основные переменные шаблона
session-start Начало сессии {{sessionId}}, {{projectName}}, {{projectPath}}
stop Завершение ответа Claude {{sessionId}}, {{projectName}}
keyword-detector При каждой отправке промпта {{prompt}}, {{sessionId}}
ask-user-question Claude запрашивает ввод пользователя {{question}}, {{sessionId}}
pre-tool-use Перед вызовом инструмента (высокая частота) {{toolName}}, {{sessionId}}
post-tool-use После вызова инструмента (высокая частота) {{toolName}}, {{sessionId}}

Переменные окружения канала ответа:

Переменная Описание
OPENCLAW_REPLY_CHANNEL Канал ответа (напр. discord)
OPENCLAW_REPLY_TARGET ID канала
OPENCLAW_REPLY_THREAD ID потока

См. scripts/openclaw-gateway-demo.mjs — эталонный шлюз, который пересылает полезные данные OpenClaw в Discord через ClawdBot.


Документация


Требования

  • Claude Code CLI
  • Подписка Claude Max/Pro ИЛИ API-ключ Anthropic

Опционально: Мульти-AI оркестрация

OMC может опционально использовать внешних AI-провайдеров для перекрёстной валидации и единообразия дизайна. Они не обязательны — OMC полностью работает без них.

Провайдер Установка Что даёт
Gemini CLI npm install -g @google/gemini-cli Ревью дизайна, единообразие UI (контекст 1M токенов)
Codex CLI npm install -g @openai/codex Валидация архитектуры, перекрёстная проверка code review

Стоимость: 3 плана Pro (Claude + Gemini + ChatGPT) покрывают всё за ~$60/месяц.


Лицензия

MIT


Вдохновлено: oh-my-opencodeclaude-hudSuperpowerseverything-claude-code

Нулевой порог вхождения. Максимальная мощность.

Star History

Star History Chart

💖 Поддержите этот проект

Если Oh-My-ClaudeCode помогает вашему рабочему процессу, рассмотрите спонсорство:

Sponsor on GitHub

Зачем спонсировать?

  • Поддержание активной разработки
  • Приоритетная поддержка для спонсоров
  • Влияние на дорожную карту и функции
  • Помощь в поддержании свободного и открытого исходного кода

Другие способы помочь

  • ⭐ Поставьте звезду репозиторию
  • 🐛 Сообщайте об ошибках
  • 💡 Предлагайте функции
  • 📝 Вносите вклад в код