ue-toolchain
f2ec704fde
The first-party agent-tool layer is Experimental and its surface moves between builds. A recipe that names a toolset does not fail loudly on the next build -- the tool is simply absent, the search finds nothing, and "nothing found" reads as "no problem here". That is the exact confusion this bundle documents, so the tokens are barred rather than discouraged. Grounded in measurement against a live editor, not in reading: - the aggregator plugin lists 21 dependencies; the server reported 53 registered toolsets from 22 plugins, one dependency contributing none; - the visible tool count flips between 3 meta-tools and every tool registered natively, on one project setting. - gate.py: ENGINE_TOOL_TOKENS and check_engine_tool_surface, registered in CHECKS; rule floor raised to 17. - test_gate.py: one poison naming a toolset, a meta-tool and a host:port. - ADR-0004 records the decision, its confirmation criteria and what is deliberately deferred. - README and CONTRIBUTING state the rule where a contributor meets it. Verified: gate.py 0 violations over 17 rules; test_gate.py 17/17 redden on their fixtures, baseline clean, surface coverage intact. The token list matches nothing under skills/ today, checked before the rule landed. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
52 lines
4.7 KiB
Markdown
52 lines
4.7 KiB
Markdown
# ue-toolchain
|
||
|
||
Инструменты для разработки на Unreal Engine через LLM-агентов: UE-плагин, MCP-сервер, скиллы, установщик, локальная документация проекта.
|
||
|
||
**Статус:** ранняя разработка. Готов и лицензирован один компонент — бандл скиллов
|
||
`plugins/ue-design-skills/` (17 скиллов, 232 записи о режимах отказа, гейт поставки
|
||
на 16 правилах). Остальные компоненты таблицы ниже — план, кода ещё нет.
|
||
|
||
## Состав (план)
|
||
|
||
| Компонент | Назначение |
|
||
|---|---|
|
||
| `Engine/` | UE-плагин редактора (C++): JSON-RPC сервер, discovery, мониторинг |
|
||
| `mcp-server/` | MCP-сервер на Python: инструменты для агентов (Hermes, Claude Code, Codex) |
|
||
| `plugins/ue-design-skills/` | Скиллы для LLM-агентов: нормы и воспроизводимые рецепты обнаружения. Харнес-нейтральны, индекс — `catalog.json` |
|
||
| `installer/` | CLI: установка плагина, регистрация MCP, копирование скиллов |
|
||
| `docs/` | Архитектурные решения и документация |
|
||
| `examples/` | Минимальный UE-проект для интеграционных тестов |
|
||
|
||
## Архитектурные решения
|
||
|
||
- [ADR-0001: Discovery over PID file](docs/architecture/decisions/0001-discovery-over-pid-file.md) — поиск запущенного редактора через UDP-broadcast, а не через файл-PID.
|
||
- [ADR-0002: Harness-neutral skill bundle](docs/architecture/decisions/0002-harness-neutral-skill-bundle.md) — репозиторий как маркетплейс, `catalog.json` как источник истины, манифест вендора как адаптер. Нейтральность проверяется гейтом, а не обещается.
|
||
- [ADR-0003: Split licensing](docs/architecture/decisions/0003-split-licensing-prose-and-code.md) — проза бандла под CC BY-ND 4.0, код и метаданные под Apache-2.0; правообладатель назван, атрибуция в титрах — просьба, а не условие.
|
||
- [ADR-0004: Engine tool surface out of skill content](docs/architecture/decisions/0004-engine-tool-surface-out-of-skill-content.md) — имена тулсетов, мета-тулов и эндпоинтов движка не попадают в `skills/`: слой экспериментальный, а его отказ молчалив. Проверяется правилом гейта P17.
|
||
|
||
## Лицензия
|
||
|
||
Copyright (c) 2026 MagentaDolphin. Издатель — Kodlo.art.
|
||
|
||
| Что | Лицензия |
|
||
|---|---|
|
||
| Код: плагин редактора, MCP-сервер, установщик, гейт поставки, манифесты | [Apache-2.0](LICENSE) |
|
||
| Проза бандла `plugins/ue-design-skills/` | [CC BY-ND 4.0](plugins/ue-design-skills/LICENSE) |
|
||
|
||
Практическая разница: код можно форкать и переиздавать как обычно; **изменённую
|
||
версию текстов публиковать как свой продукт нельзя**. Всё остальное разрешено —
|
||
использование в коммерческой работе, правка под свою студию, дословное
|
||
распространение с указанием авторства, адаптеры формата под другие харнесы и
|
||
переводы.
|
||
|
||
На то, что вы создаёте с помощью инструмента, притязаний нет: ни на игру, ни на
|
||
код, ни на документацию, ни на выручку.
|
||
|
||
Если инструмент помог — упоминание приветствуется, но ничем не обязывает.
|
||
Атрибуция обязательна только при распространении самих материалов.
|
||
|
||
Оговорка: выбор лицензий — не юридическое заключение. Материал бандла получен
|
||
чтением стороннего сэмпла, распространяемого по UE EULA; в поставке нет чужого
|
||
кода, адресов и дословных выдержек, но заключением о вашем использовании это не
|
||
является.
|