Функции v3.0: Полное руководство по Категориям и Навыкам

Обзор версии

oh-my-opencode v3.0 — это значительный релиз, представляющий совершенно новую систему Категорий и Навыков, революционизирующую способ координации ИИ-агентов. Эта версия делает ИИ-агентов более специализированными, гибкими и составными.

Ключевые улучшения:

🎯 Система Категорий: 7 встроенных категорий задач с автоматическим выбором модели
🛠️ Система Навыков: 3 встроенных профессиональных пакета навыков для внедрения предметных знаний
🔄 Динамическая композиция: Свободное комбинирование Категории и Навыков через delegate_task
🚀 Sisyphus-Junior: Новый исполнитель делегированных задач, предотвращающий бесконечные циклы
📝 Гибкая конфигурация: Поддержка пользовательских Категорий и Навыков

Основная функция 1: Система Категорий

Что такое Категория?

Категория — это предустановка конфигурации специализированного агента, оптимизированная для конкретной области. Она отвечает на ключевой вопрос: "Какой тип работы это?"

Каждая Категория определяет:

Используемую модель (model)
Параметр температуры (temperature)
Настройку промпта (prompt mindset)
Способность рассуждения (reasoning effort)
Разрешения на инструменты (tools)

7 Встроенных Категорий

Категория	Модель по умолчанию	Температура	Сценарии использования
`visual-engineering`	`google/gemini-3-pro`	0.7	Frontend, UI/UX, дизайн, стилизация, анимации
`ultrabrain`	`openai/gpt-5.2-codex` (xhigh)	0.1	Глубокое логическое рассуждение, сложные архитектурные решения, требующие обширного анализа
`artistry`	`google/gemini-3-pro` (max)	0.7	Задачи с высокой креативностью/художественные задачи, новые идеи
`quick`	`anthropic/claude-haiku-4-5`	0.1	Простые задачи — изменение одного файла, исправление опечаток, простые изменения
`unspecified-low`	`anthropic/claude-sonnet-4-5`	0.1	Задачи, не подходящие к другим категориям, низкая нагрузка
`unspecified-high`	`anthropic/claude-opus-4-5` (max)	0.1	Задачи, не подходящие к другим категориям, высокая нагрузка
`writing`	`google/gemini-3-flash`	0.1	Документация, эссе, техническое письмо

Источник: docs/category-skill-guide.md:22-30

Как использовать Категории?

При вызове инструмента delegate_task укажите параметр category:

typescript

// Делегировать frontend-задачу категории visual-engineering
delegate_task(
  category="visual-engineering",
  prompt="Добавить адаптивный компонент диаграммы на страницу дашборда"
)

Система автоматически:

Выберет Категорию visual-engineering
Использует модель google/gemini-3-pro
Применит temperature: 0.7 (высокая креативность)
Загрузит настройку промпта Категории

Sisyphus-Junior: Исполнитель делегированных задач

Когда вы используете Категорию, специальный агент Sisyphus-Junior выполнит задачу.

Ключевые функции:

❌ Не может повторно делегировать задачи другим агентам
🎯 Сосредоточен на назначенных задачах
🔄 Предотвращает бесконечные циклы делегирования

Цель дизайна: Обеспечить фокус агентов на текущей задаче, избегая сложности, вызванной послойным делегированием задач.

Основная функция 2: Система Навыков

Что такое Навык?

Навык — это механизм, который внедряет предметную экспертизу (Context) и инструменты (MCP) в агента. Он отвечает на другой ключевой вопрос: "Какие инструменты и знания необходимы?"

3 Встроенных Навыка

1. `git-master`

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

Эксперт Git
Обнаружение стиля коммитов
Разделение атомарных коммитов
Создание стратегий ребейза

MCP: Нет (использует команды Git)

Сценарии использования: Коммиты, поиск истории, управление ветками

2. `playwright`

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

Автоматизация браузера
Веб-тестирование
Скриншоты
Сбор данных

MCP: @playwright/mcp (автоматически выполняется)

Сценарии использования: Валидация UI после реализации, написание E2E-тестов

3. `frontend-ui-ux`

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

Внедрение мышления дизайнера
Руководства по цветам, типографике, анимации

Сценарии использования: Красивая работа с UI за пределами простой реализации

Источник: docs/category-skill-guide.md:57-70

Как использовать Навыки?

Добавьте массив load_skills в delegate_task:

typescript

// Делегировать быструю задачу и загрузить навык git-master
delegate_task(
  category="quick",
  load_skills=["git-master"],
  prompt="Зафиксировать текущие изменения. Следовать стилю сообщений коммитов."
)

Система автоматически:

Выберет Категорию quick (Claude Haiku, низкая стоимость)
Загрузит Навык git-master (внедрит Git-экспертизу)
Запустит Sisyphus-Junior для выполнения задачи

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

Вы можете добавить пользовательские Навыки напрямую в .opencode/skills/ в корне проекта или в ~/.claude/skills/ в каталоге пользователя.

Пример: .opencode/skills/my-skill/SKILL.md

markdown

---
name: my-skill
description: Мой профессиональный пользовательский навык
mcp:
  my-mcp:
    command: npx
    args: ["-y", "my-mcp-server"]
---

# Промпт моего навыка

Это содержимое будет внедрено в системный промпт агента.
...

Источник: docs/category-skill-guide.md:87-103

Основная функция 3: Возможность динамической композиции

Стратегия композиции: Создание специализированных агентов

Комбинируя различные Категории и Навыки, вы можете создавать мощные специализированные агенты.

🎨 Дизайнер (Реализация UI)

Категория: visual-engineering
load_skills: ["frontend-ui-ux", "playwright"]
Эффект: Реализовать красивый UI и проверить результаты рендеринга прямо в браузере

🏗️ Архитектор (Обзор дизайна)

Категория: ultrabrain
load_skills: [] (чистое рассуждение)
Эффект: Использовать способность логического рассуждения GPT-5.2 для глубокого анализа системной архитектуры

⚡ Сопровождающий (Быстрые исправления)

Категория: quick
load_skills: ["git-master"]
Эффект: Быстро исправить код, используя экономичную модель, и создать чистые коммиты

Источник: docs/category-skill-guide.md:111-124

Руководство по промптам delegate_task

При делегировании задач чёткие и конкретные промпты критически важны. Включите следующие 7 элементов:

TASK: Что нужно сделать? (одна цель)
EXPECTED OUTCOME: Каков результат?
REQUIRED SKILLS: Какие навыки должны быть загружены через load_skills?
REQUIRED TOOLS: Какие инструменты должны быть использованы? (белый список)
MUST DO: Что обязательно должно быть сделано (ограничения)
MUST NOT DO: Что никогда не должно быть сделано
CONTEXT: Пути к файлам, существующие шаблоны, справочные материалы

❌ Плохой пример:

"Исправь это"

✅ Хороший пример:

TASK: Исправить проблему с мобильной разметкой в LoginButton.tsxCONTEXT: src/components/LoginButton.tsx, используется Tailwind CSS MUST DO: Изменить flex-direction на брейкпоинте md:MUST NOT DO: Изменять существующую десктопную разметку EXPECTED: Кнопка выравнивается вертикально на мобильных устройствах

Источник: docs/category-skill-guide.md:130-148

Руководство по конфигурации

Схема конфигурации Категорий

Вы можете точно настроить Категории в oh-my-opencode.json.

Поле	Тип	Описание
`description`	string	Понятное описание цели Категории. Показывается в промптах delegate_task.
`model`	string	Идентификатор ИИ-модели для использования (например, `anthropic/claude-opus-4-5`)
`variant`	string	Вариант модели (например, `max`, `xhigh`)
`temperature`	number	Уровень креативности (0.0 ~ 2.0). Ниже — более детерминированно.
`top_p`	number	Параметр ядерного сэмплинга (0.0 ~ 1.0)
`prompt_append`	string	Содержимое, добавляемое к системному промпту при выборе этой Категории
`thinking`	object	Конфигурация модели мышления (`{ type: "enabled", budgetTokens: 16000 }`)
`reasoningEffort`	string	Уровень усилий рассуждения (`low`, `medium`, `high`)
`textVerbosity`	string	Многословность текста (`low`, `medium`, `high`)
`tools`	object	Управление использованием инструментов (используйте `{ "tool_name": false }` для отключения)
`maxTokens`	number	Максимальное количество токенов ответа
`is_unstable_agent`	boolean	Пометить агента как нестабильного — принудительный фоновый режим для мониторинга

Источник: docs/category-skill-guide.md:159-172

Пример конфигурации

jsonc

{
  "categories": {
    // 1. Определить новую пользовательскую категорию
    "korean-writer": {
      "model": "google/gemini-3-flash",
      "temperature": 0.5,
      "prompt_append": "Вы корейский технический писатель. Поддерживайте дружелюбный и ясный тон."
    },

    // 2. Переопределить существующую категорию (изменить модель)
    "visual-engineering": {
      "model": "openai/gpt-5.2",
      "temperature": 0.8
    },

    // 3. Настроить модель мышления и ограничить инструменты
    "deep-reasoning": {
      "model": "anthropic/claude-opus-4-5",
      "thinking": {
        "type": "enabled",
        "budgetTokens": 32000
      },
      "tools": {
        "websearch_web_search_exa": false // Отключить веб-поиск
      }
    }
  },

  // Отключить навыки
  "disabled_skills": ["playwright"]
}

Источник: docs/category-skill-guide.md:175-206

Другие важные улучшения

Помимо системы Категорий и Навыков, v3.0 включает следующие важные улучшения:

Улучшения стабильности

✅ Версия помечена как стабильная (3.0.1)
✅ Оптимизирован механизм делегирования агентов
✅ Улучшена возможность восстановления ошибок

Оптимизации производительности

✅ Сокращено ненужное внедрение контекста
✅ Оптимизирован механизм опроса фоновых задач
✅ Улучшена эффективность оркестрации нескольких моделей

Совместимость с Claude Code

✅ Полностью совместим с форматом конфигурации Claude Code
✅ Поддерживает загрузку Навыков, Команд и MCP Claude Code
✅ Автоматическое обнаружение и конфигурация

Источник: README.md:18-20, README.md:292-304

Следующие шаги

Система Категорий и Навыков в v3.0 создаёт гибкую основу для расширения oh-my-opencode. Если вы хотите глубже изучить использование этих новых функций, обратитесь к следующим разделам:

Категории и Навыки: Динамическая композиция агентов — Подробное руководство по использованию
Встроенные Навыки: Автоматизация браузера и Git-эксперт — Глубокий анализ Навыков
Расширенная конфигурация: Агенты и управление разрешениями — Руководство по пользовательской конфигурации

Начните изучать эти новые функции и сделайте свои ИИ-агенты более специализированными и эффективными!

5 минут для начала

Подключение ваших учётных записей ИИ

Работа как команда

Что делать при возникновении проблем

Справочник и миграция

Журнал изменений

Функции v3.0: Полное руководство по Категориям и Навыкам

Обзор версии

Основная функция 1: Система Категорий

Что такое Категория?

7 Встроенных Категорий

Как использовать Категории?

Sisyphus-Junior: Исполнитель делегированных задач

Основная функция 2: Система Навыков

Что такое Навык?

3 Встроенных Навыка

1. `git-master`

2. `playwright`

3. `frontend-ui-ux`

Как использовать Навыки?

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

Основная функция 3: Возможность динамической композиции

Стратегия композиции: Создание специализированных агентов

🎨 Дизайнер (Реализация UI)

🏗️ Архитектор (Обзор дизайна)

⚡ Сопровождающий (Быстрые исправления)

Руководство по промптам delegate_task

Руководство по конфигурации

Схема конфигурации Категорий

Пример конфигурации

Другие важные улучшения

Улучшения стабильности

Оптимизации производительности

Совместимость с Claude Code

Следующие шаги

Функции v3.0: Полное руководство по Категориям и Навыкам ​

Обзор версии ​

Основная функция 1: Система Категорий ​

Что такое Категория? ​

7 Встроенных Категорий ​

Как использовать Категории? ​

Sisyphus-Junior: Исполнитель делегированных задач ​

Основная функция 2: Система Навыков ​

Что такое Навык? ​

3 Встроенных Навыка ​

1. git-master ​

2. playwright ​

3. frontend-ui-ux ​

Как использовать Навыки? ​

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

Основная функция 3: Возможность динамической композиции ​

Стратегия композиции: Создание специализированных агентов ​

🎨 Дизайнер (Реализация UI) ​

🏗️ Архитектор (Обзор дизайна) ​

⚡ Сопровождающий (Быстрые исправления) ​

Руководство по промптам delegate_task ​

Руководство по конфигурации ​

Схема конфигурации Категорий ​

Пример конфигурации ​

Другие важные улучшения ​

Улучшения стабильности ​

Оптимизации производительности ​

Совместимость с Claude Code ​

Следующие шаги ​

Функции v3.0: Полное руководство по Категориям и Навыкам

Обзор версии

Основная функция 1: Система Категорий

Что такое Категория?

7 Встроенных Категорий

Как использовать Категории?

Sisyphus-Junior: Исполнитель делегированных задач

Основная функция 2: Система Навыков

Что такое Навык?

3 Встроенных Навыка

1. `git-master`

2. `playwright`

3. `frontend-ui-ux`

Как использовать Навыки?

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

Основная функция 3: Возможность динамической композиции

Стратегия композиции: Создание специализированных агентов

🎨 Дизайнер (Реализация UI)

🏗️ Архитектор (Обзор дизайна)

⚡ Сопровождающий (Быстрые исправления)

Руководство по промптам delegate_task

Руководство по конфигурации

Схема конфигурации Категорий

Пример конфигурации

Другие важные улучшения

Улучшения стабильности

Оптимизации производительности

Совместимость с Claude Code

Следующие шаги