Перейти к основному содержимому

Blackbox

Делегируйте задачи по кодингу CLI-агенту Blackbox AI. Мультимодельный агент со встроенным судьёй, который выполняет задачи через несколько LLM и выбирает лучший результат. Требуется CLI Blackbox и API-ключ Blackbox AI.

Метаданные навыка​

ИсточникОпционально — установка через vibeos skills install official/autonomous-ai-agents/blackbox
Путьoptional-skills/autonomous-ai-agents/blackbox
Версия1.0.0
АвторVibeOS (Nous Research)
ЛицензияMIT
Платформыlinux, macos, windows
ТегиCoding-Agent, Blackbox, Multi-Agent, Judge, Multi-Model
Связанные навыкиclaude-code, codex, vibeos-agent

Справочник: полный SKILL.md​

к сведению

Ниже приведено полное описание навыка, которое VibeOS загружает при его активации. Агент видит эти инструкции, когда навык активен.

Blackbox CLI

Делегируйте задачи по кодингу Blackbox AI через терминал VibeOS. Blackbox — это мультимодельный CLI-агент для кодинга, который распределяет задачи между несколькими LLM (Claude, Codex, Gemini, Blackbox Pro) и использует судью для выбора лучшей реализации.

CLI является открытым (GPL-3.0, TypeScript, форк Gemini CLI) и поддерживает интерактивные сессии, неинтерактивные одноразовые задачи, контрольные точки, MCP и переключение моделей зрения.

Предварительные требования​

  • Установленный Node.js 20+
  • Установленный CLI Blackbox: npm install -g @blackboxai/cli
  • Или установка из исходников:
    git clone https://github.com/blackboxaicode/cli.git
    cd cli && npm install && npm install -g .
  • API-ключ с app.blackbox.ai/dashboard
  • Настройка: выполните blackbox configure и введите ваш API-ключ
  • Используйте pty=true в вызовах терминала — CLI Blackbox является интерактивным терминальным приложением

Одноразовые задачи​

terminal(command="blackbox --prompt 'Добавь JWT-аутентификацию с refresh-токенами в Express API'", workdir="/путь/к/проекту", pty=true)

Для быстрых черновиков:

terminal(command="cd $(mktemp -d) && git init && blackbox --prompt 'Создай REST API для задач с SQLite'", pty=true)

Фоновый режим (длительные задачи)​

Для задач, занимающих минуты, используйте фоновый режим, чтобы отслеживать прогресс:

# Запуск в фоне с PTY
terminal(command="blackbox --prompt 'Переработай модуль аутентификации для использования OAuth 2.0'", workdir="~/project", background=true, pty=true)
# Возвращает session_id

# Мониторинг прогресса
process(action="poll", session_id="<id>")
process(action="log", session_id="<id>")

# Отправка ввода, если Blackbox задаёт вопрос
process(action="submit", session_id="<id>", data="yes")

# Завершение при необходимости
process(action="kill", session_id="<id>")

Контрольные точки и возобновление​

CLI Blackbox имеет встроенную поддержку контрольных точек для приостановки и возобновления задач:

# После завершения задачи Blackbox показывает тег контрольной точки
# Возобновление с последующей задачей:
terminal(command="blackbox --resume-checkpoint 'task-abc123-2026-03-06' --prompt 'Теперь добавь ограничение частоты запросов к эндпоинтам'", workdir="~/project", pty=true)

Команды сессии​

Во время интерактивной сессии используйте эти команды:

КомандаЭффект
/compressСжать историю разговора для экономии токенов
/clearОчистить историю и начать заново
/statsПросмотреть текущее использование токенов
Ctrl+CОтменить текущую операцию

Ревью PR​

Клонируйте во временную директорию, чтобы не изменять рабочее дерево:

terminal(command="REVIEW=$(mktemp -d) && git clone https://github.com/user/repo.git $REVIEW && cd $REVIEW && gh pr checkout 42 && blackbox --prompt 'Проверь этот PR относительно main. Ищи ошибки, проблемы безопасности и качество кода.'", pty=true)

Параллельная работа​

Запускайте несколько экземпляров Blackbox для независимых задач:

terminal(command="blackbox --prompt 'Исправь баг с логином'", workdir="/tmp/issue-1", background=true, pty=true)
terminal(command="blackbox --prompt 'Добавь модульные тесты для аутентификации'", workdir="/tmp/issue-2", background=true, pty=true)

# Мониторинг всех
process(action="list")

Мультимодельный режим​

Уникальная особенность Blackbox — выполнение одной задачи через несколько моделей и оценка результатов. Настройте используемые модели через blackbox configure — выберите несколько провайдеров, чтобы включить рабочий процесс с председателем/судьёй, где CLI оценивает результаты от разных моделей и выбирает лучший.

Ключевые флаги​

ФлагЭффект
--prompt "задача"Неинтерактивное одноразовое выполнение
--resume-checkpoint "тег"Возобновление с сохранённой контрольной точки
--yoloАвтоматическое одобрение всех действий и переключений моделей
blackbox sessionЗапуск интерактивной чат-сессии
blackbox configureИзменение настроек, провайдеров, моделей
blackbox infoОтображение системной информации

Поддержка зрения​

Blackbox автоматически обнаруживает изображения во вводе и может переключаться на мультимодальный анализ. Режимы VLM:

  • "once" — Переключить модель только для текущего запроса
  • "session" — Переключить на всю сессию
  • "persist" — Остаться на текущей модели (без переключения)

Лимиты токенов​

Управляйте использованием токенов через .blackboxcli/settings.json:

{
"sessionTokenLimit": 32000
}

Правила​

  1. Всегда используйте pty=true — CLI Blackbox является интерактивным терминальным приложением и зависнет без PTY
  2. Используйте workdir — держите агента сфокусированным на правильной директории
  3. Фон для длительных задач — используйте background=true и мониторьте с помощью инструмента process
  4. Не вмешивайтесь — мониторьте с помощью poll/log, не завершайте сессии из-за их медлительности
  5. Сообщайте результаты — после завершения проверьте, что изменилось, и подведите итог для пользователя
  6. Кредиты стоят денег — Blackbox использует кредитную систему; мультимодельный режим расходует кредиты быстрее
  7. Проверяйте предварительные требования — убедитесь, что CLI blackbox установлен, прежде чем пытаться делегировать