SkillFoxx
Telegram

AIBridge — скилл

AIBridge дает агентам рабочий цикл в Unity: сборка, логи, сцены и префабы, ввод в Play Mode, скриншоты и отладка плеера

  • 227 ★ репозитория
  • Последний коммит
  • MIT
Скилл

Широкий доступ

Почему такой уровень

  • Меняет сцены, префабы и ассеты проекта через API Unity и запускает временный C# код в редакторе
  • Runtime Bridge в сборке открывает плеер для команд, при HybridCLR можно отправлять в него код
Все причины и проверки

liyingsong99/aibridgeАвтор:liyingsong99

Установка

Ручная установка

Текст для агента

Пакет ставит пользователь: Unity Package Manager, Git URL `https://github.com/liyingsong99/AIBridge.git`. Потом в Unity откройте `AIBridge/Workflows`, вкладку Skills, отметьте клиентов и нажмите `Install Selected Integrations`. Запускай CLI из корня проекта: сначала `compile unity`, затем `get_logs --logType Error`, правки полей через `inspector set_property`. Выполнение кода в плеере без явного разрешения пользователя не включай.

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Меняет сцены, префабы и ассеты проекта через API Unity и запускает временный C# код в редакторе
  • Runtime Bridge в сборке открывает плеер для команд, при HybridCLR можно отправлять в него код

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

AIBridge — локальный пакет для Unity, после установки которого агент перестает ограничиваться чтением и правкой текста скриптов. Он находит настоящие пути ассетов, читает иерархию сцен и префабов, меняет поля Инспектора через API Unity, запускает компиляцию и тесты, читает консоль, имитирует ввод в Play Mode, снимает скриншоты и GIF и подключается к собранным плеерам. Пакет состоит из нескольких слоев. CLI (`AIBridgeCLI`) принимает команды вроде `compile unity` и `get_logs --logType Error`. Скиллы AIBridge записываются в стандартную папку каждого выбранного клиента, например `.codex/skills/` у Codex. Runtime Bridge внутри собранного плеера отдает состояние, логи, скриншоты, замеры производительности и снимок интерфейса. Индекс кода ищет объявления C# по имени, а рецепты рабочих процессов запускают проверенные шаги и пишут отчеты в `.aibridge/workflows/runs/`. С установленным HybridCLR пакет может собрать временный диагностический код в редакторе и отправить его в целевой плеер, но только если выполнение кода во время работы явно включено. Для Android есть путь через `adb reverse`.

Для кого. Unity-разработчикам, которые правят проект вместе с Codex, Claude или Cursor и хотят, чтобы агент после правок сам проверял компиляцию, логи и интерфейс.

Подходит, если

  • Агент поправил скрипт, и сразу после этого стоит убедиться, что Unity компилируется, и прочитать ошибки консоли
  • Все префабы кнопок проверяются на отсутствие звука клика, причем сначала идет пробный запуск патча
  • Баг интерфейса воспроизводится так: вход в Play Mode, нажатие кнопки, снимок экрана
  • Кнопка логина молчит в сборке на Android, и из плеера забирают логи, скриншот и замеры
  • Объявление класса `PlayerController` ищется по имени через индекс кода

Не подходит, если

  • Проект не на Unity: пакет целиком завязан на редактор Unity и его API
  • Вам нужен готовый MCP-сервер для Unity: AIBridge работает через CLI и скиллы, протокол MCP он не заменяет
  • Нужен запуск произвольного кода в сборке без явного разрешения: он включается отдельно и только при установленном HybridCLR

Пример запроса к агенту

Включи Play Mode, нажми кнопку инвентаря, проверь, что панель открылась, и приложи скриншот и ошибки консоли

Ограничения

  • Нужен проект на Unity и установка пакета через Package Manager по адресу Git; зеркало лежит на Gitee.
  • Ввод в Play Mode требует EventSystem, команда `focus` работает только в Windows, а `dialog` только из CLI.
  • Код через `code runtime_execute` отправляется в плеер только при установленном HybridCLR и явном включении выполнения кода.
  • Индекс кода читает только имена объявлений C#, для настоящего анализа файлы `.cs` открывают напрямую.

Как отключить. Удалите пакет через Unity Package Manager, а затем уберите установленные скиллы из папок клиентов (например `.codex/skills/`), каталог `.aibridge/` и корневой `AGENTS.md`, если создавали его шаблоном.

Частые вопросы

Как установить AIBridge в проект Unity?

Добавьте пакет в Unity Package Manager по адресу `https://github.com/liyingsong99/AIBridge.git` (ветка `dev` для свежих правок), затем откройте `AIBridge/Workflows`, отметьте клиентов на вкладке Skills и нажмите `Install Selected Integrations`.

Чем AIBridge отличается от MCP-серверов для Unity?

mcp-for-unity управляет редактором через протокол MCP. AIBridge работает на уровне инструментов Unity через CLI и скиллы и дополнительно умеет подключаться к собранным плеерам, но протокол MCP не заменяет.

Можно ли отлаживать собранную игру на телефоне?

Да, для сборок с включенным Runtime Bridge. По локальной сети плеер находит `runtime discover`, а для Android через USB выполняют `adb reverse tcp:27182 tcp:27182` и подключаются по HTTP на 127.0.0.1.

Где хранятся отчеты рабочих процессов?

В каталоге `.aibridge/workflows/runs/` внутри проекта: манифест запуска, результаты команд, артефакты, проверки и отчет в Markdown.

Нужен ли для AIBridge сервер MCP?

Нет. Агент вызывает CLI `AIBridgeCLI` по инструкциям установленных скиллов. README сравнивает пакет с мостами в стиле Unity MCP, но протокол MCP он не заменяет.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы
Выбор редакции

Официальный набор скиллов Unity для агентов: работа с редактором, сборки, 2D и 3D, UI, URP, звук, мультиплеер и монетизация

СкиллРасширенный доступ1,2 тыс.

UnrealBridge дает ИИ-агенту управление редактором Unreal Engine: ассеты, Blueprint, анимации и уровень с откатом каждой правки.

СкиллШирокий доступ313

Плагин Unity с MCP-сервером, скиллами и CLI: агент управляет сценами, ассетами, скриптами и тестами в редакторе Unity

MCP-серверШирокий доступ4,6 тыс.

Три скилла одного автора для агента на Windows: безопасный PowerShell, чтение видео Bilibili и работа с открытым Unity Editor

СкиллРасширенный доступ288

Команда uloop и 21 скилл: агент собирает, тестирует и запускает проект Unity, читает логи и проверяет игру в Play Mode.

СкиллШирокий доступ598

Пакет Unity с локальным мостом в редакторе: агент через MCP управляет сценами, префабами, сборками и тестами

MCP-серверШирокий доступ257

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйАвторизацияЗвезды репозиторияГлавное отличие
AIBridge (эта карточка)нет227
MCP for Unityнетне нужна15 943управляет редактором Unity из агента через протокол MCP
Unity Skillsнет1 244официальный набор скиллов Unity: редактор, сборки, 2D и 3D, UI

Коротко о README

Страница представляет AIBridge как набор из CLI, скиллов, индекса кода и Runtime Bridge и перечисляет сценарии работы: цикл правки с компиляцией, проверка префабов, ввод в Play Mode, отладка плеера, отчеты о производительности. Дальше идут установка через Package Manager, настройка скиллов в окне Workflows и справочник команд, свернутый по умолчанию.

Бейдж для README

Исходный SKILL.md

---
name: aibridge
description: Unity Editor and Player Runtime CLI integration for AIBridge. Use for harness snapshot reads, Unity compile/logs/assets/scenes/prefabs/Inspector, screenshots/GIFs, Play Mode input, Runtime Player targets, focus/menu/game view, or AIBridgeCLI syntax. Route batch/multi, complex prefab patching, and direct UnityYAML edits to specialized Skills
---

# AI Bridge Unity Skill

## Invocation

Run from Unity project root. `$CLI` is the platform AIBridge CLI; on Windows PowerShell prefer:

```powershell
& "./.aibridge/cli/AIBridgeCLI.exe" <command> [action] [options]
```

Common options: `--timeout`, `--raw`, `--pretty`, `--json`, `--stdin`, `--help`, `--on-dialog`. Installed command references live under `references/` after Skill install

## Harness Snapshot

Project-side capabilities are in Root Rule / workflow rules. `$CLI harness status` is optional diagnosis only — not enablement/freshness preflight

## Operating Rules

- Unity validation: `compile unity`. `compile dotnet` is an extra check, not a Unity fallback
- Imported asset path discovery: `asset search/find --format paths` when Editor is available
- Edit order: `inspector set_property/set_properties` → `aibridge-prefab-patch` → Editor scripts → `unity-yaml-editing` only for unsupported YAML structure
- Prefab asset edits: `assetPath + objectPath + componentName`/`componentIndex`; `componentInstanceId` is scene-only
- `focus` Windows-only; `dialog` CLI-only; `input` needs Play Mode + EventSystem
- `runtime`: quick `list_targets` first; `--probe true` only for port scan; UI start with `runtime.ui.snapshot`
- Code Index: only when Root Rule declares enabled — load `aibridge-code-index` for declaration-name lookup
- Do not proactively clean `.aibridge` cache unless the user asks for maintenance

Сообщить о проблеме